CLI tool for creating sio2 task packages
Project description
sinol-make
sinol-make is a CLI tool for creating and verifying problem packages
for sio2
with features such as:
- measuring time and memory in the same deterministic way as sio2,
- running the solutions in parallel,
- keeping a git-friendly report of solutions' scores,
- catching mistakes in the problem packages as early as possible,
- and more.
Contents
Why?
The purpose of the tool is to make it easier to create good problem packages
for official competitions, which requires collaboration with other people
and using a multitude of "good practices" recommendations.
While there are several excellent CLI tools for creating tests and solutions,
they lack some built-in mechanisms for verifying packages and finding mistakes
before uploading the package to the judge system.
As sinol-make was created specifically for the sio2 problem packages,
by default it downloads and uses sio2's deterministic mechanism of measuring
solutions' runtime, called oiejq.
Installation
It's possible to directly install sinol-make through Python's package manager pip, which usually is installed alongside Python:
pip3 install sinol-make
As oiejq works only on Linux-based operating systems,
we do not recommend using operating systems such as Windows or macOS.
Nevertheless sinol-make supports those operating systems,
though there are additional installation steps required to use
other tools for measuring time (which are non-deterministic and produce reports different from sio2):
- Windows (WSL):
apt install time timeout - macOS:
brew install gnu-time coreutils
Usage
The availabe commands (see sinol-make --help) are:
sinol-make run-- Runs selected solutions (by default all solutions) on selected tests (by default all tests) with a given number of CPUs. Measures the solutions' time with oiejq, unless specified otherwise. After running the solutions, it compares the solutions' scores with the ones saved in config.yml. Runsinol-make run --helpto see available flags.sinol-make inwer-- Verifies whether input files are correct using your "inwer.cpp" program. You can specify what inwer program to use, what tests to check and how many CPUs to use. Runsinol-make inwer --helpto see available flags.
Reporting bugs and contributing code
- Want to report a bug or request a feature? Open an issue.
- Want to help us build
sinol-make? Create a Pull Request and we will gladly review it.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sinol_make-1.2.1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2e3a1769d45d5144ac583961a511d396351c7a80c425fd0facca69f5e1799d7c |
|
| MD5 | 2eb38febcc72030b9bb0ad528f7ca207 |
|
| BLAKE2b-256 | a0d9292018c436b5af335b5d36a885b6cecd2429299e1b2819d7a4b168235428 |
