各種オンラインジャッジにて、提出前の入出力チェックを補助するスクリプトです。
プログラミングの授業などで、課題の採点支援にも利用できます。

• 解答ソースコードのコンパイル
• 解答コードの実行・入出力チェック・実行時間測定
• テストケースの管理
  • 一部サイトについて、テストケースの自動取得に対応
    (現在の対応サイト: AtCoder)
• ソースコードのテンプレート管理

• Python3
  • Requests
  • parse
  • BeautifulSoup4

依存パッケージは pip install -r requirements.txt でインストールできます。

問題用のディレクトリを作成し、ソースコード、テストケースファイルを作成します。

$ # いずれかを実行
$ ./oj-helper setup [-c contest_name] -p problem_name [-l language]
$ ./oj-helper s [-c contest_name] -p problem_name [-l language]
$ ./oj-helper s -u problem_url [-l language]

カレントディレクトリ以下に{contest_name}/{problem_name}ディレクトリが作られ、 その中に{problem_name}.{language}, {problem_name}.sampleファイルが作成されます。
languageには、使いたい言語のソースコードの拡張子(cpp, pyなど)を指定します。 指定しなければ、後述するconfig.json内のdafault_languageの値が使われます。

テストケース自動取得対応サイトについては、 -u problem_url オプションにて、contest_name, problem_name, 後述のテストを一度に設定できます。

problem_nameディレクトリに移動し、ソースコード({problem_mane}.{language})を作成します。

$ # いずれかを実行
$ ./oj-helper add-test
$ ./oj-helper a

問題文に添付されているテストケースの 入力をコピペする(最後の改行を忘れずに)、Ctrl-Dを押す、出力をコピペする、Ctrl-Dを押すことでテストが登録されます。 上のコマンドを繰り返し実行することで、複数のテストケースを追加できます。

誤ったテストケースを追加してしまった場合は、{problem_name}.sampleファイルを直接編集してください。

$ # いずれかを実行
$ ./oj-helper test [-l language] [-f filename] [-t timeout] [-e FLOAT_ERROR] [-v VERBOSE]
$ ./oj-helper t [-l language] [-f filename] [-t timeout] [-e FLOAT_ERROR] [-v VERBOSE]

filenameを指定しなければ、{problem_name}.{language}を実行します。 これ以外のソースコードを実行する場合は指定してください。
timeoutには、問題で指定されている制限時間(秒)を指定します(デフォルト: 2)。 指定された時間の2倍の時間以内にプログラムが終了しなければ、プログラムの実行を打ち切ります。

オプション:

• [-e|--float-error] FLOAT-ERROR: 出力の各行がfloatのみだった場合に、相対誤差FLOAT-ERROR以下であれば正解とみなします。 (default: 1e-4)
• [-v|--verbose] VERBOSE: 結果表示の詳細度を設定します。(0: 正誤判定のみ 1: 誤答のみ入出力を表示 2: 全ケースの入出力を表示 default: 2)

上で使った3つのモード指定(setup, add-test, test)は、それぞれ頭文字を取ったalias(s, a, t)で代用できます。

問題用のディレクトリを作成し、テストケースファイルを作成します。

$ ./oj-helper setup [-c contest_name] -p problem_name [-l language]

ソースコードファイルも作られますが、使用しない場合は削除して構いません。

$ ./oj-helper add-test

$ ./oj-helper test [-l language] -f filename [-t timeout]

設定は、config.jsonファイルに記述します。config_sample.jsonをコピーして編集してください。

• default_language: -l オプションを指定しなかった場合に使われる言語名を指定します。
  言語名はソースコードの拡張子としてください。
• templates:  テンプレートファイルを配置するディレクトリを指定します。({src_dir}は、このプログラムのソースコード(oj-helper)のディレクトリです)
• commands: 言語ごとに、コンパイルコマンド(compile_cmd)、テスト実行コマンド(test_cmd)を指定します。
  インタプリタ言語などコンパイル不要な言語については、compile_cmdを省略してください。
  コマンド中では、ソースコードのファイル名を{fname}、コンパイルで生成される実行ファイル名を{oname}で指定できます。
• sites:  テストケース取得対応サイトについて、ログイン情報を登録します。(平文で保存されるため、管理にはご注意ください)

./oj-helper setupで作成されるソースコードは、templates/template.{language}をコピーすることで作成されています。 このファイルを書き換えたり、新たな言語のテンプレートを追加することでカスタマイズできます。