Skip to content

README.md

Latest commit

 

History

History
executable file
·
61 lines (46 loc) · 3.3 KB

README.md

File metadata and controls

executable file
·
61 lines (46 loc) · 3.3 KB
Raw

#Wecode

Wecode judge, originally forked fromSharif Judge, is a free and open source online judge for C, C++, Java and Python programming courses.

The web interface is written in PHP (CodeIgniter framework) and the main backend is written in BASH.

Python is not sandboxed yet. Just a low level of security is provided for python. If you want to use Wecode judge for python, USE IT AT YOUR OWN RISK or provide sandboxing yourself.

The full documentation is at https://github.com/mjnaderi/Sharif-Judge/tree/docs

Download the latest release from https://github.com/mjnaderi/Sharif-Judge/releases

Features

  • Multiple user roles (admin, head instructor, instructor, student)
  • Sandboxing (not yet for python)
  • Cheat detection (similar codes detection) using Moss
  • Custom rule for grading late submissions
  • Submission queue
  • Download results in excel file
  • Download submitted codes in zip file
  • "Output Comparison" and "Tester Code" methods for checking output correctness
  • Add multiple users
  • Problem Descriptions (PDF/Markdown/HTML)
  • Rejudge
  • Scoreboard
  • Notifications
  • ...

Requirements

For running Wecode judge, a Linux server with following requirements is needed:

  • Webserver running PHP version 5.3 or later with mysqli extension
  • PHP CLI (PHP command line interface, i.e. php shell command)
  • MySql or PostgreSql database
  • PHP must have permission to run shell commands using shell_exec() php function (specially shell_exec("php");)
  • Tools for compiling and running submitted codes (gcc, g++, javac, java, python2 and python3 commands)
  • It is better to have perl installed for more precise time and memory limit and imposing size limit on output of submitted code.

Installation

  1. Clone latest release from github repository into a directory with read/write permission. Then put the index.php file in your public directory
  2. Take note the location of system and application folders, then save their full path in index.php file ($system_path and $application_folder variables).
  3. Create a MySql or PostgreSql database for Wecode judge. Do not install any database connection package for C/C++, Java or Python.
  4. For some weird reason with CodeIgniter, your database name must not contain dot "." character
  5. Copy application/config/database.php.example to application/config/database.php and set approriate database connection settings
  6. Make application/cache/Twig writable by php.
  7. Open the main page of Wecode judge in a web browser and follow the installation process.
  8. Log in with your admin account.
  9. [IMPORTANT] Move folders tester and assignments somewhere outside your public directory. Then save their full path in Settings page. These two folders must be writable by PHP. Submitted files will be stored in assignments folder. So it should be somewhere not publicly accessible.
  10. [IMPORTANT] Secure Wecode judge

After Installation

License

GPL v3