Contest Management System

Homepage: http://cms-dev.github.io/

Preambule

This is a fork of the original CMS version 1.4rc1, adapted to the needs of the Brazilian Olympiad in Informatics (https://olimpiada.ic.unicamp.br).

It implements three modifications:

1. Allow different time and memory limits for different programming languages. Two new JSONB columns were created in the database for the table "dataset", to store a dictionary for the memory limits (column "memory_limit_lang") and a dictionary for the time limits (column "time_limit_lang"). Initially, for all languages, the time limit is the value of the usual "time_limit" task parameter, the memory limit is the value of the usual "memory limit" task parameter. Then, in the admin interface, the values for each language can be set.

   Affected files:

   • cms/db/base.py
   • cms/cms/db/task.py
   • cms/grading/Job.py
   • cms/server/admin/handlers/base.py
   • cms/server/admin/handlers/task.py
   • cms/server/admin/templates/task.html
   • cms/server/contest/templates/contest.html
   • cms/server/contest/templates/overview.html
   • cms/server/contest/templates/task_description.html

2. Allow using the pbkdf2 hashing method for passwords (we wanted to use the same passwords the contestants already had for our main web server, Django).

   Affected files:

   • cmscommon/crypto.py
   • cmscommon/hashers.py (added)
   • cmscontrib/AddUser.py
   • cmscontrib/UpdatePassword.py (added)
   • cms/server/admin/templates/fragments/hashed_password_form.html
   • setup.py

3. Put a logo in the header of the contest page.

   Affected files:

   • cms/server/contest/static/cws_style.css
   • cms/server/contest/static/img/logo.svg (added)
   • cms/server/contest/templates/header_logo.html (added) (you need to edit header_logo.html to set the link address)

Many thanks to the CMS team for this wonderfull system!

Ricardo Anido (ranido@ic.unicamp.br)

Introduction

CMS, or Contest Management System, is a distributed system for running and (to some extent) organizing a programming contest.

CMS has been designed to be general and to handle many different types of contests, tasks, scorings, etc. Nonetheless, CMS has been explicitly build to be used in the 2012 International Olympiad in Informatics, held in September 2012 in Italy.

Download

For end-users it's best to download the latest stable version of CMS, which can be found already packaged at http://cms-dev.github.io/.

This git repository, which contains the development version in its master branch, is intended for developers and everyone interested in contributing or just curious to see how the code works and wanting to hack on it.

Please note that since the sandbox is contained in a git submodule you should append --recursive to the standard git clone command to obtain it. Or, if you have already cloned CMS, simply run the following command from inside the repository:

git submodule update --init

Support

To learn how to install and use CMS, please read the documentation, available at https://cms.readthedocs.org/.

If you have questions or need help troubleshooting some problem, contact us in the chat at gitter, or write on the support mailing list contestms-support@googlegroups.com, where no registration is required (you can see the archives on Google Groups).

To help with the troubleshooting, you can upload on some online pastebin the relevant log files, that you can find in /var/local/log/cms/ (if CMS was running installed) or in ./log (if it was running from the local copy).

If you encountered a bug, please file an issue on GitHub following the instructions in the issue template.

Please don't file issues to ask for help, we are happy to help on the mailing list or on gitter, and it is more likely somebody will answer your query sooner.

You can subscribe to contestms-announce@googlegroups.com to receive announcements of new releases and other important news. Register on Google Groups.

For development queries, you can write to contestms-discuss@googlegroups.com and as before subscribe or see the archives on Google Groups.

Testimonials

CMS has been used in several official and unofficial contests. Please find an updated list at http://cms-dev.github.io/testimonials.html.

If you used CMS for a contest, selection, or a similar event, and want to publicize this information, we would be more than happy to hear from you and add it to that list.