Secure online judge for CS teachers, programming websites and contests.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.meta
.travis
camisole
deployment
doc
tests
.coveragerc
.gitignore
.travis.yml
CHANGELOG.rst
LICENSE
Makefile
README.rst
requirements-dev.txt
requirements.txt
setup.cfg
setup.py

README.rst

camisole

camisole logo

https://travis-ci.org/prologin/camisole.svg?branch=master https://coveralls.io/repos/github/prologin/camisole/badge.svg?branch=master

camisole is a secure online judge for code compilation and execution. You give some untrusted source code and a test suite, and camisole compiles the code and runs it against the test suite.

It uses isolate as a backend to safely compile and execute source codes using Linux kernel features such as namespaces, cgroups, chroot and resources limits.

Documentation

The full documentation of Camisole, including installation instructions and usage examples, is available at https://camisole.prologin.org

Features

  • Built-in support for a wide variety of languages, including Ada, C, C#, C++, Haskell, Java, JavaScript, Lua, OCaml, Pascal, Perl, PHP, Python, Ruby, Scheme…
  • Isolation: camisole runs both the compilation and execution stages in a sandboxed environment provided by isolate
  • Limitation of resources (time, wall-time, memory…)
  • Simple HTTP + JSON or MessagePack interface

Demo

camisole is used through a simple HTTP/JSON interface. Sending a program is as simple as that:

$ curl -s localhost:8080/run -d '{"lang": "python", "source": "print(42)"}' | python -m json.tool
{
    "tests": [
        {
            "stdout": "42\n",
            "stderr": "",
            "meta": {
                "status": "OK",
                "exitcode": 0,
                "wall-time": 0.067,
                "cg-mem": 2528,
                "killed": 0,
                "exitsig": 0,
                "exitsig-message": null,
                "time": 0.019,
                "max-rss": 6264,
                "csw-forced": 12,
                "csw-voluntary": 4,
                "message": null
            },
            "name": "test000",
            "exitcode": 0
        }
    ],
    "success": true
}

License

GPLv2+, see the LICENSE file.