A grading framework for evaluating programming assignments
This program uses Docker and Python to easily grade many assignments in an encapsulated, safe manner. The general process starts by creating an image for a class or an assignment. That image can be given a payload, a protected grading script, which has a grading hooks. The grade module, when ran, creates an individual container for each student's assignment and runs a payload hook. The payload then returns a JSON response with stdin, stdout, and additional response information depending on the image ran.
See the tutorial for an idea of how to get started using
This project is setup using buildout. It's super easy to get
grader up and running:
You'll probably need the following libraries...
And, of course, you'll want Docker if you plan to do anything interesting at all. Grader requires docker with API version >= 1.20. We use
PUT /containers/(id)/archive) from docker-py.
# Bootstrap buildout python3 bin/bootstrap-buildout.py # Setup your development environment with buildout bin/buildout
Now you're done! When it sets up your environment, buildout creates a couple of executables and places them in
bin/ for you. They are:
- buildout : That's buildout. Run it whenever you add eggs to
- grader : That's
- python : "What? Another Python!?" Yeah... This is an ipython interpreter. It's handy because it has access to all the same packages that were installed for
Check your style
It's important to keep our code looking consistent. There's a tool installed by buildout called
flake8 that will check your Python source for issues in style. Simply run it like this:
# Make sure you run this in your grader directory. flake8 will recursively check source files for style issues. bin/flake8 grader/
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size redkyn_grader-0.1.0-py3-none-any.whl (6.2 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size redkyn-grader-0.1.0.tar.gz (27.6 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for redkyn_grader-0.1.0-py3-none-any.whl