pisek 1.2.0

Tool for developing tasks for programming competitions.

Pisek ⌛

Tool for developing tasks for programming competitions. Currently used by:

• Kasiopea
• Czech Informatics Olympiad

And was used by:

• CEOI 2024

Install

Pisek requires Python ≥ 3.11. Install with pip:

pip install pisek

For upgrading add --upgrade:

pip install pisek --upgrade

Testing tasks

First create a config file as documented here. You can also reference the examples for Kasiopea mode and CMS mode.

pisek test

This command tests the task in the current directory. It tests all task parts (generator, checker, solutions and judge).

Task testing overview

What pisek verifies (roughly in order):

• Samples exist
• The generator generates inputs
  • A Kasiopea generator respects the seed and is deterministic
• The checker accepts all inputs
  • If checker_distinguishes_subtasks=on, it rejects inputs for harder subtasks
• The judge works
  • It accepts the samples
  • It doesn't crash on malicious output
• The solutions finish as expected
  • They get the expected number of points
  • They succeed/fail on each subtask as expected
• Data files (inputs and outputs) are valid
  • They are in the correct encoding
  • They don't contain unprintable characters
  • They have a newline at the end
  • The files are reasonably small
• The task is complete
  • A CMS judge has no redundant lines in its stdout/stderr
  • If solution_for_each_subtask=on, there exists a dedicated solution for each subtask

Testing given programs

For fast testing of only the solution solve_cool.cpp use:

pisek test solution solve_cool

For testing on multiple inputs use (only in Kasiopea mode) use:

pisek test solution solve_cool -n 42

Similarly the generator can be tested using:

pisek test generator

Useful options

Test all solutions, don't stop on first failure:

pisek test --full

Test each solution on all inputs, even when the result is clear:

pisek test --all-inputs

Use a different time limit (in seconds) for testing solutions:

pisek test --timeout 5

Interpret warnings as failures (for a final check):

pisek test --strict

Cleaning

Pisek can create a lot of files used for testing. Remove them by running:

pisek clean

Visualization

For visualizing the running time for each solution and testcase:

pisek test --testing-log  # test the task
pisek visualize      # visualize

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Copyright (c)   2019 - 2022 Václav Volhejn <[e-mail]>
Copyright (c)   2019 - 2022 Jiří Beneš <[e-mail]>
Copyright (c)   2020 - 2022 Michal Töpfer <[e-mail]>
Copyright (c)   2022        Jiří Kalvoda <[e-mail]>
Copyright (c)   2023        Daniel Skýpala <[e-mail]>
Copyright (c)   2024        Benjamin Swart <[e-mail]>