Package: sinol-make
sinol-makesinol-makeis a CLI tool for creating and verifying problem packages
forsio2with 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.ContentsWhy?InstallationUsageReporting bugs and contributing codeWhy?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, calledoiejq.InstallationIt's possible to directly installsinol-makethrough Python's package manager pip, which usually is installed alongside Python:pip3installsinol-makepipinstalls thesinol-makeexecutable in~/.local/bin/directory,
so make sure this directory is in yourPATH.Here'show to add a directory toPATH.Asoiejqworks only on Linux-based operating systems,we do not recommendusing operating systems such as Windows or macOS.
Neverthelesssinol-makesupports 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):Debian-based systems (Ubuntu, usually Windows WSL):apt install timeArch-based systems:pacman -S timemacOS:brew install gnu-time coreutilsAutocompletion (optional)If you would like to have autocompletion forsinol-makecommands,
run the following command and refresh the shell (e.g. by opening a new terminal):activate-global-python-argcompleteUsageThe availabe commands (seesinol-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. If you're using oiejq, make sure you are not running on efficiency
cpu cores. You can check if you have themlike this. To run on normal cpu cores, usetaskset -c 8-15 sinol-make ..., assuming that cpu cores 8-15 are not efficiency cores.
Runsinol-make run --helpto see available flags.sinol-make gen-- Generate input files using ingen program (for example prog/abcingen.cpp for abc task).
Whenever the new input differs from the previous one, the model solution will be used to generate the new output file.
You can also specify your ingen source file which will be used.
Runsinol-make gen --helpto see available flags.sinol-make ingen-- Generate input files using ingen program (for example prog/abcingen.cpp for abc task).
You can also specify your ingen source file which will be used.
Runsinol-make ingen --helpto see available flags.sinol-make outgen-- Generate output files using the model solutions. Runsinol-make outgen --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.sinol-make export-- Creates archive ready to upload to sio2 or szkopul. Runsinol-make export --helpto see all available flags.sinol-make doc-- Compiles all LaTeX files in doc/ directory to PDF. Runsinol-make doc --helpto see all available flags.sinol-make init [id]-- Creates package from templateon githuband sets task id to provided[id]. Requires an internet connection to run.Reporting bugs and contributing codeWant to report a bug or request a feature?Open an issue.Want to help us buildsinol-make? Create a Pull Request and we will gladly review it.