hoj-judger v0.3.0

H2 OJ Judger

The project is a tool written in C++ to judge a program for Hydrogen OJ.

Requirement

Kernel

Add swapaccount=1 to GRUB_CMDLINE_LINUX in /etc/default/grub.

GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"

Then run command below:

update-grub && reboot

Install in Node.js Project

Requirement: Yarn

yarn add hoj-judger

Build by Yourself

Requirement: CMake 3.4 or higher, g++ 9 or higher

./build.sh

How to Use

Use in Terminal

hoj-judger --source=<source-file> --problem=<data-dir> --language=<language> --checker=<checker-path> --output=<output-dir>

Here is the description for each argument. |Argument|Description|Example| |:--|:--|:--| |source|Path to source file.|test/aplusb_problem/src.cpp| |problem|Path to problem directory which contains *.in/*.out and config.yml.|test/aplusb_problem/data| |language|Language identifier defined in the config.|cpp98| |checker|Path to checker.|node/bin/hoj-checker| |output|Path to output directory.|test/aplusb_problem|

In the output directory, hoj-judger will create exe, output.out, compile.log and result.yml while running. If chosen language doesn't need to be compiled, it will only create output.out and result.yaml. For details of result.yaml, see below.

Use in Node.js Project

const HojJudger = require('../node/index');

HojJudger.judge({
    code_path: './test/aplusb_problem/src.cpp',
    problem_path: './test/aplusb_problem/data',
    output_path: './test/aplusb_problem/',
    language: 'cpp98'
}).then(result => {
    console.log(result);
});

Also support TypeScript.

Config

Judger Config

Path: /path/to/work/directory/hoj-judger-config.yml

language:
  cpp98: # This is an identifier for a language.
    compile: "g++ \"%source\" -o \"%executable\" -DONLINE_JUDGE -DHOJ_JUDGER" # This is a command for COMPILE event.
    run: "\"%executable\"" # This is a command for RUN event.
  nodejs:
    run: "node \"%executable\""

Here is the description for each variable. |Variable|Description|Example| |:--|:--|:--| |source|Path to source file.|./test/aplusb_problem/src.cpp| |executable|Path to executable file.|./test/aplusb_problem/exe|

If any language doesn't need to be compiled, compile can be ignored. But run is always required.

Problem Config

Path: /path/to/problem/data/config.yml

file: aplusb # Prefix of each input and output file.
mode: oi # It can only be filled with "oi" now.
type: default # It can only be filled with "default" now.
case_count: 2 # Count of test cases.
case:
  - space: 131072 # Maximum space limit (KiB).
    time: 1000 # Maximum time limit (ms).
    score: 50 # Score of the test case.
  - space: 131072
    time: 1000
    score: 50

Each data file should be named like aplusb1.in, aplusb1.out. If file is ignored, the data file name should be named like 1.in, 1.out.

Judge Result

Path: /path/to/output/directory/result.yml

score: 10 # Total score.
time: 299 # Total time (ms).
space: 1612 # Maximum used space (KiB).
status: 4 # Judge status.
case_count: 2 # Count of test cases.
case:
  - space: 1612 # Used space (KiB).
    time: 27 # Used time (ms).
    score: 0 # Score.
    status: 12 # Test case status.
  - space: 1604
    time: 26
    score: 50
    status: 1 

Here is the description for judge status. |Status|Abbr.|Value|Description| |:--|:--|:--|:--| |NO_STATUS|/|0|Unused status.| |ACCEPTED|AC|1|Accepted.| |COMPILE_ERROR|CE|2|Compile error.| |SYSTEM_ERROR|SE|3|System error. |UNACCEPTED|WA|4|Unaccepted.| |UNKNOWN_ERROR|UKE|5|Unknown error.|

Here is the description for test case status. |Status|Abbr.|Value|Description| |:--|:--|:--|:--| |NO_STATUS|/|0|Unused status.| |ACCEPTED|AC|1|Accepted.| |COMPILE_ERROR|CE|2|Compile error.| |COMPILE_MEMORY_LIMIT_EXCEEDED|CMLE|3|Compile memory limit exceeded.| |COMPILE_TIME_LIMIT_EXCEEDED|CTLE|4|Compile time limit exceeded.| |MEMORY_LIMIT_EXCEEDED|MLE|5|Memory limit exceeded.| |OUTPUT_LIMIT_EXCEEDED|OLE|6|Output limit exceeded.| |PRESENTATION_ERROR|PE|7|Presentation error.| |RUNTIME_ERROR|RE|8|Runtime error.| |SYSTEM_ERROR|SE|9|System error.| |TIME_LIMIT_EXCEEDED|TLE|10|Time limit exceeded.| |UNKNOWN_ERROR|UKE|11|Unknown error.| |WRONG_ANSWER|WA|12|Wrong answer.|