kget
This is a client for downloading, testing, and submitting c++ solutions to kattis.
Installation
Requires python3 and make.
python3 -m pip install -e git+https://github.com/aozgaa/kget.git#egg=kget
Usage
Get/Download/Fetch problem
kget get <problem_name>
eg: for problem stringmatching, this is:
$ kget get stringmatching
Downloading samples
Samples extracted to 'stringmatching'
The remainder of this document uses the problem stringmatching.
Adding Tests
The kattis problems include sample problems, but additional cases are often needed to exercise corner cases or large problem instances.
Input/Output Tests
Create a <testname>.in and <testname>.ans file in the problem directory, eg:
touch stringmatching/t1.in
touch stringmatching/t1.ans
The test will then run when invoked with either of the methods described below.
(Python) Generated Input/Outputs
Create a <testname>.in.py and/or <testname>.ans.py file in the problem directory, eg:
touch stringmatching/t1.in.py
touch stringmatching/t1.ans.py
The test runner of your choice will then generate the corresponding *.in/*.ans file by capturing the stdout of the python script, called with no arguments.
Run Tests with kget
$ kget test stringmatching
Testing stringmatching
make: Entering directory '/<omitted>/stringmatching'
g++ -g solution.cpp -o solution
running test: ./solution < stringmatching.in > stringmatching.out
real 0m0.001s
user 0m0.000s
sys 0m0.001s
test-stringmatching: comparing stringmatching.out stringmatching.ans
0a1,4
> 2 4
>
> 5
> 7
running test: ./solution < t1.in > t1.out
real 0m0.001s
user 0m0.001s
sys 0m0.000s
test-t1: comparing t1.out t1.ans
Failed tests:
stringmatching.out
make: Leaving directory '/<omitted>/stringmatching'
Run Tests with make
$ make -C stringmatching/
make: Entering directory '/<omitted>/stringmatching'
g++ -g solution.cpp -o solution
running test: ./solution < stringmatching.in > stringmatching.out
real 0m0.001s
user 0m0.000s
sys 0m0.001s
test-stringmatching: comparing stringmatching.out stringmatching.ans
0a1,4
> 2 4
>
> 5
> 7
running test: ./solution < t1.in > t1.out
real 0m0.001s
user 0m0.001s
sys 0m0.000s
test-t1: comparing t1.out t1.ans
Failed tests:
stringmatching.out
make: Leaving directory '/<omitted>/stringmatching'
Compare Diffs
It is sometimes useful to see an interactive diff when debugging.
The make target vimdiff or vimdiff-<testname> will open vimdiff with
.in, .out, and .ans files for comparison.
Submit
$ kget submit stringmatching
Submission received. Submission ID: 101<omitted>
Submission url: https://open.kattis.com/submissions/101<omitted>
Contributing
Contributions are welcome! Please feel free to open a pull request with a description of your improvement.
This application is built using setuptools. In particular, the package can be built with
python -m build
and installed locally with
pip install --editable .
Testing
Testing is currently manual. Only a "golden test" is checked in to compare basic clone functionality across changes:
python ./src/kget.py get stringmatching
diff --brief --recursive stringmatching/ testdata/stringmatching/