A python/django based system for testing c/c++ solutions to algoritmic problems
Python HTML Other
Switch branches/tags
Nothing to show
Latest commit ff050e4 Apr 30, 2017 @Alaxe committed on GitHub Fixed formatting of README.md
Permalink
Failed to load latest commit information.
blog
judge
judgeSystem
media
media_manager
static
users
.gitignore
.gitmodules
LICENSE
README.md
judge-celery.service
manage.py
requirements.txt
run_celery
setup.py

README.md

judgeSystem

A python/django based system for testing c/c++ solutions to algoritmic problems

What it does now:

  • Basic Login/register funtionality
  • Task/test editing
  • Testing solutions
  • A simple blog
  • Searching by tags

Required software:

  • A linux distribution (tested on Arch and Ubuntu)
  • Python 3 (tested with 3.5)
  • Python modules: view requirements.txt
  • g++ compiler
  • A database (postgresql recommended)
  • rabbitmq
  • isolate sandbox

How to install:

  1. Clone the repository git clone https://github.com/Alaxe/judgesystem.git

  2. (Optional) install virtualenv (guide)

  3. Setup settings judgeSystem/settings.py

    • EMAIL_<setting_name> - Used for account confirmation, default server is gmail
    • RECAPTCHA_PRIVATE_KEY and RECAPTCHA_PUBLIC_KEY - self explanatory, You can get them from their website
    • SITE_HOST the domain / ip of the server; used for some links
    • ALLOWED_HOSTS
    • SECRET_KEY
    • TIME_ZONE
  4. Setup database

    • install it (guide for postgres)
    • Fill in DATABASE in judgeSystem/settings.py
  5. Other dependencies

    • Python modules sudo pip install -r requirements.txt --upgrade
    • Static files python manage.py collectstatic
    • (optinal) create a super user python manage.py createsuperuser
  6. Database migrations

    • Generate any missing migrations python manage.py createmigrations
    • Create the database schema with python manage.py migrate
  7. Install rabbitmq

    • sudo apt-get install rabbitmq
    • Start the service sudo systemctl start rabbitmq-server and enable it sudo systemctl enable rabbitmq-server (i.e. make it start on boot) Note: This assumes that you have systemd. While that's the case with newer distros, you may have to use an your disto's init system
  8. Install isolate

    • Clone the repository git clone https://github.com/ioi/isolate
    • Install make install (Has to be run from the repository's directory)
  9. (optional) Install a proper web server (you can use the development server, which comes with django, but it's not suitable for production) Here's a guide for nginx with uwsgi, a bit out of date though

    • When configuring uwsgi instead of module use wsgi-file and the full path to judgesystem/judgeSystem/wsgi.py
    • Most distros have systemd services so instead of sudo service ... use sudo systemctl (start|restart|stop|enable) (nginx|uwsgi)
  10. (optional) Install celery as a service (systemd)

  • Add to judge-celery.service the full path to the repository
  • Copy the file to create the service sudo cp judge-celery.service /etc/systemd/system/ and reload the services with sudo systemctl daemon-reload
  • Control it with sudo systemctl (start|stop|restart) judge-celery and make it auto-start with sudo systemctl enable judge-celery

How to run:

  • Web server
    • If you installed a nginx it should be running as a service
    • For the development serverepython manage.py runserver (you can add a url:port pair as a parameter)
  • Celery
    • If you installed the service it should be running
    • Otherwise sudo ./run_celery