Kattis online judge command line tool written in Python. Requires Python 3.
Run git clone https://github.com/Kattis/kattis-cli to clone the repository.
To run the client directly, cd into the kattis-cli directory and run python submit.py.
See the section for your operating system below for instructions on how to install the submission client as a command runnable from anywhere on your file system.
If the python command is not installed, try using python3 instead.
To run the client as a command, you can create a file kattis.bat in kattis-cli:
@echo off
python %~dp0\submit.py %*If you are using a virtual environment, replace python with <venv>\Scripts\python, where <venv> is the path to your environment.
To install it, you can add the kattis-cli directory to your %PATH% variable.
To do that, run setx PATH "%PATH%;C:\Users\user\Desktop\kattis-cli" where C:\Users\user\Desktop\kattis-cli is the path to your cloned repository.
You can now run the command kattis from anywhere!
To run the client as a command, you can create an executable file kattis in kattis-cli:
#!/bin/sh
python "${BASH_SOURCE%/*}/submit.py" "$@"If you are using a virtual environment, replace python with <venv>/bin/python, where <venv> is the path to your environment.
To install it, you can add the kattis-cli directory to your $PATH variable.
To do that, open the file ~/.bash_profile in a text editor and add the line export PATH="$PATH:/Users/user/Desktop/kattis-cli", where /Users/user/Desktop/kattis-cli is the path to the kattis-cli directory, at the end of the file.
You can now run the command kattis from anywhere!
Note: You might need admin privileges to change the file.
Before running the submission client, you need to download a configuration file. This file includes a secret personal token that allows you to log in. It should be placed in your home directory, or in the same directory as submit.py, and be called .kattisrc.
The easiest way to use the client is if you have named your source code to problemid.suffix, where suffix is something suitable for the language (e.g., .java for Java, .c for C, .cc or .cpp for C++, .py for Python, .cs for C#, .go for Go, and so on...).
Let's assume you're solving the problem Hello World! (with problem id hello) and that your java solution is in the file Hello.java. Then you can simply run kattis Hello.java, and the client will make the correct guesses. You will always be prompted before a submission is sent.
The client requires the requests and lxml PyPi packages.
To install them, you can cd into the kattis-cli directory and run the command pip install -U -r requirements.txt.
Alternatively, you can install them directly using pip install -U requests lxml.
While not required, it is recommended that you use a virtual environment to avoid breaking other projects. Check out this guide or the documentation. When installing packages or running the client, remember to activate the environment first.
If you plan to modify the client itself, the package types-lxml makes this more convenient in some editors.
If you get an error message like this: ModuleNotFoundError: No module named 'requests' when you run kattis it's because the module 'requests' isn't installed.
To install the module, follow the above instructions or check out this StackOverflow answer.
If you are using a virtual environment, make sure you activated it before installing the packages and before running the client.
If you get an error message like this: This environment is externally managed when trying to install the required packages, the recommended solution is to use a virtual environment.
Make sure to activate it before running pip. Check out this StackOverflow answer for other solutions.
The submit client can handle multiple files in a submission. For such submissions, the filename and suffix of the first file listed on the command line is the basis of the guesses. It is ok to list a file multiple times, e.g., kattis Hello.java *.java will work as intended.
In case the client guesses wrong, you can correct it by specifying a command line option. Running kattis -h will list all options. The options are:
-p <problem_id>: overrides problem guess-m <mainclass>: overrides mainclass guess-l <language>: overrides language guess-f: forces submission (i.e., no prompt)