SIO2 is a free platform for carrying out algorithmic contests and OIOIOI is its main component — the web interface.
Vagrant (for development)
You can easily start development and run oioioi out of the box with vagrant. Just enter the directory where Vagrantfile and this README are placed, and type:
It will create an instance of virtual machine with web server and judges running.
You can specify configuration in vagrant.yml. Supported configuration options (with example):
port: 8001 # run oioioi on port 8001 instead of the default 8000 runserver_cmd: runserver_plus # use manage.py runserver_plus instead of manage.py runserver
Docker (for deployment)
Additionally, there are available docker files to create images containing our services.
To start with, create oioioi-base image with a command:
docker build -t oioioi-base -f Dockerfile.base .
To run the infrastructure:
To start additional number of workers:
docker-compose scale worker=<number>
as described in Docker docs.
Docker (for development)
It is possible to develop using docker images, but this we do not recommend it. Better use Vagrant or install OIOIOI manually, as described in the next section.
To develop with docker after creating oioioi-base image, create oioioi image with:
docker build -t oioioi .
OIOIOI_UID=$(id -u) docker-compose -f docker-compose-dev.yml up
to start the infrastructure in development mode. Current dirrectory with source code will be binded to /sio2/oioioi/ inside running container, and logs from services will be availible outside of the container in ./logs/.
In both cases, oioioi web interface will be availible at localhost:8000, and the user admin with password admin will be created. If you are using docker installation in production encvironment remember to change the password.
See INSTALL for instructions.
See UPGRADING for instructions.
Amanda is recommended for doing OIOIOI backups. Sample configuration with README
is available in
Documentation for developers:
OIOIOI has a big suite of unit tests. You can run them in following way:
test.sh- a simple test runner, use from virtualenv
test_selenium.sh- long selenium tests, use from virtualenv
tox [path/to/module[::TestClass[::test_method]]] [-- arg1 arg2 ...]- runs pytest in isolated environemnt
-n NUM- run tests using NUM CPUs
-v- increase verbosity
-q- decrease verbosity
-x- exit after first failure
-lf- runs only tests that failed last time
--runslow- runs also tests marked as slow
Well, we don't have a full-fledged User's Guide, but feel free to propose what should be added here.
Creating task packages
To run a contest, you obviously need some tasks. To add a task to a contest in OIOIOI, you need to create an archive, called task package. Here are some pointers, how it should look like:
Here are some useful links: