Skip to content

aben20807/local-judge

Repository files navigation

Local Judge

PyPI Downloads Python version GitHub license Coding style Language grade: Python Maintainability

Given source code, Makefile (or build commands), input files, and answer files then judge the program locally.

NOTE: this package is not an "online judge" (UVa, LeetCode, etc.) that allows you to solve some algorithmic problems but a tool that can judge (or correct) the students' compiler assignments (included but not limited to) by themselves and by the teaching assistants. You can still use this package to help simulate "online judge", which is not the goal of this work.

Workflow

Workflow

Screenshot

screenshot

Installation

  • For global usage:

    $ pip install local-judge
  • With virtualenv:

    $ virtualenv -p python3.6 venv
    $ source venv/bin/activate
    $ pip install local-judge

Features

  • Both
    • Automatically build the source code into executable
    • Automatically run the executable for each input and compare output with answer
    • Customization friendly
    • Able to leverage git diff tool to compare the result with the answer
  • Student (judge)
    • Without any dependencies but standard build-in python packages
  • TA (ta_judge)
    • Two dependencies packages: openpyxl, rarfile
    • Support different zip type (.zip, .rar)
    • When error is occurred, not interrupt or exit but just log it
    • Output to excel table
    • Multiprocessing

Environment (Recommended)

  • Ubuntu 18.04
  • python 3.6
  • git 2.17.1 (Our default diff tool for comparing between output and answer is git. Please make sure that you have installed it.)

Usage Examples

Documentation of Configuration

judge

  • judge.conf: be placed in the root of your program [example]
    • BuildCommand: how to build the executable
    • Executable: the name of the executable
    • RunCommand: how to run the executable with input and output
    • Inputs: input files (can use wildcard)
    • TempOutputDir: the temporary directory to place output files
    • DiffCommand: how to find differences between output and answer
    • DeleteTempOutput: whether to delete the temporary output after finding the differences (true or false)
    • AnswerDir: the directory where contains the answer files corresponding to the input files
    • AnswerExtension: the extension of the answer files
    • ExitOrLog: exit when any error occurred or just log the error
    • ScoreDict: the dictionary for the mapping of correctness and score
    • TotalScore: used if the number of tests is more than ScoreDict
    • Timeout: execution timeout for each test case

ta_judge

  • ta_judge.config: [example]
    • First part is judge.conf
    • StudentList: the execl file which contains student name and id
    • StudentsZipContainer: the directory where contains students' submit homeworks
    • StudentsPattern: used to match zip files
    • UpdateStudentPattern: used for update score of single student
    • StudentsExtractDir: the directory where contains extracted homeworks
    • ScoreOutput: the output excel file
    • ExtractAfresh: true: re-extract zipped file for each judge time; false: use pre-extracted files (under StudentsExtractDir) to judge

Contributing

Please make sure that you have installed pre-commit for linting the code with the black style.

Development

Environment

$ virtualenv -p python3.7 venv3.7
$ source venv3.7/bin/activate
$ python setup.py develop
$ pip install -e .
$ pip list
Package            Version Location
------------------ ------- ---------------------------------
black              21.12b0
click              8.0.3
et-xmlfile         1.1.0
importlib-metadata 4.10.0
local-judge        2.4.7   /home/ben/pro/selfpro/local-judge
mypy-extensions    0.4.3
openpyxl           3.0.9
pathspec           0.9.0
pip                21.0.1
platformdirs       2.4.1
rarfile            4.0
setuptools         54.1.1
tomli              1.2.3
typed-ast          1.5.1
typing-extensions  4.0.1
wheel              0.36.2
zipp               3.6.0

Run the test locally

$ python -m pytest tests/test_cli.py

License

MIT