boychunli/moodle-local_onlinejudge

Online Judge plugin for Moodle 2.x

This plugin is in BETA version and NOT recommended to use in production sites

Introduction

The Online Judge 2 plugin for Moodle 2 is designed for courses involving programming. It can automatically grade submitted source code by testing them against customizable test cases (ACM-ICPC/Online Judge style).

It contains three modules:

1. judgelib - a local plugin which provides an online judge function library to any part of Moodle.
2. judges - judge engine plugins for judgelib.
3. clients - any kind of moodle plugins can work as the client of judgelib to provide UI to teachers and students and call the judgelib to judge submissions.

Now, this plugin includes two judge engines:

1. sandbox compiles and executes C/C++ programs locally in a protected environment. Supports Linux 32/64-bit only.
2. ideone posts all data to ideone.com which compiles and executes programs remotely. Supports 40+ languaes, such as C/C++, Java, Python, C#, JavaScript, Perl, PHP. Works in both Windows and Linux.

Now, this plugin includes one client:

1. Online Judge Assignment Type - online judge version of the official advanced uploading of files assignment activity.

The workflow is:

1. Administrators install and config it.
2. Teachers create Online Judge Assignment Activities and setup testcases etc.
3. Students submit code in Online Judge Assignment Activities.
4. The judge daemon judges the submissions in background.
5. Teachers and students get judge results in Online Judge Assignment Activities.

Prerequisite

In Linux

• Moodle 2.0 or above
• php-cli
• (optional but recommended) make, gcc and g++. For 64-bit system, libc 32-bit development libraries, e.g. libc6-dev-i386, glibc-devel.i386, are required.
• (optional but recommended) pcntl and posix extension for php-cli

In Windows

• Moodle 2.0 or above
• php-cli

Download

Download it from https://github.com/hit-moodle/moodle-local_onlinejudge/archives/master

or using git:

git clone git://github.com/hit-moodle/moodle-local_onlinejudge.git onlinejudge

Installation / Upgrading

MOODLE_PATH means the root path of your moodle installation. Do NOT ignore the bold steps during upgrading.

For clean installation of Moodle 2.3 or 2.4 (rather than an upgraded site):

You need to enable the 2.2 assignment type in administration under:

 Site admin > Plugins > Activity modules > Manage activities

In Linux

1. If the directory MOODLE_PATH/local/onlinejudge exists, remove it.
2. Make sure the directory name of this plugin is onlinejudge. If not, rename it.
3. Put onlinejudge into MOODLE_PATH/local/
4. run MOODLE_PATH/local/onlinejudge/cli/install_assignment_type.
5. Login your site as admin and access /admin/index.php. The plugins will be installed/upgraded.
6. In shell, sudo -u www-data php MOODLE_PATH/local/onlinejudge/cli/judged.php, to launch the judge daemon.
7. If you would like to use sandbox judge engine, then cd MOODLE_PATH/local/onlinejudge/judge/sandbox/sand/ && make

In Windows

1. If the folder MOODLE_PATH\local\onlinejudge exists, remove it.
2. Make sure the folder name of this plugin is onlinejudge. If not, rename it.
3. Put onlinejudge into MOODLE_PATH\local\
4. Enter folder MOODLE_PATH\local\onlinejudge\cli and run install_assignment_type.bat.
5. Login your site as admin and access /admin/index.php. The plugins will be installed/upgraded.
6. In command prompt, php.exe MOODLE_PATH\local\onlinejudge\cli\judged.php -v, to launch the judge daemon.

Usage

Online Judge Assignment Type

After installation, there will be a new assignment type called Online Judge appears in the "Add an activity..." drop down list. Simply click it and follow the inline help.

In settings block, there are links to testcase management and rejudge all.

Judge Daemon

The judge daemon has several helpful options for debugging propose. Try argument --help.

Links

Home:

• https://github.com/hit-moodle/moodle-local_onlinejudge

FAQ:

• https://github.com/hit-moodle/moodle-local_onlinejudge/wiki

Bug reports, feature requests, help wanted and other issues:

• https://github.com/hit-moodle/moodle-local_onlinejudge/issues