rlr(Recursion Local Runner)は、RecursionCSで公開されている問題を、ローカル環境で実行するためのツールです。
以下の特徴があります。
- ReucsionCSから、問題のテストケースをローカルに取得する。
- 指定されたコマンドで、取得したテストケースのローカルジャッジを実行する。
- ローカルで実行できるので、RecusrionCSのエディタでサポートされていない言語でも問題を解くことが可能。
また、ローカルで実行できるため、好きなエディタで編集、実行が可能となっています。
vimneovimEmacsSpacemacsnanoVScodeEclipseIntelliJサクラエディタ秀丸エディタメモ帳and more...
インストールで必要な作業は2つです。
- ファイルの取得
- インストールの実行
Gitリポジトリをクローン、もしくはzipでダウンロードして下さい。
zipでダウンロードの場合は、画像の様に、Download ZIPをクリックして下さい。
ファイルがローカルに保存されますので、ファイルを解凍して下さい。
ローカルにgitコマンドがインストールされている場合は、以下の様にクローンすることでもファイルを取得できます。
こちらはzip圧縮されていないので、解凍の必要はありません。
git clone https://github.com/kip2/rlr.gitインストール方法は、プラットフォームにより差があります。
実行権限を与えて、install.shを実行して下さい。
# 実行権限の付与
chmod +x install.sh
# インストールの実行
./install.sh
# もしくはbashで起動する
bash install.shインストールの確認として、バージョン情報の出力を確認して下さい。
# オプションのVは大文字なことに注意する
rlr -V
# もしくは
rlr --versionコマンドプロンプト(cmd)、もしくはPowerShellでディレクトリを開き、 install.batを実行して下さい。
install.batインストールの確認として、バージョン情報の出力を確認して下さい。
# オプションのVは大文字なことに注意する
rlr -V
# もしくは
rlr --versionuninstall.shに実行権限を与え、その後実行して下さい。
# 実行権限の付与
chmod +x uninstal.sh
# uninstallの実行
./uninstall.sh
# もしくは
bash uninstall.shコマンドプロンプト(cmd)、もしくはPowerShellでダウンロードした本リポジトリのディレクトリを開き、 uninstall.batを実行して下さい。
uninstall.batrlrの使用にあたっては、以下の手順が必要です。
- RecursionCSへの初回ログインを実施する(
loginコマンド)。 - RecursionCSから問題のテストケースをダウンロードする(
downloadコマンド)。 - 問題を解くコードを、好きなエディタで書く。
- 3で書いたコードで、問題が解けるかのジャッジを実行する(
judgeコマンド)。
RecursionCSは会員制サイトとなっています。 そのため、あらかじめログインする必要があります。
初回ログインとして、以下のログインコマンドを実施して下さい。
rlr login
# もしくは
rlr lコマンド実行後、メールアドレスとパスワードを入力すると、ログイン処理が実行されます。
NOTE: なお、一度ログインをした後は、認証期限がこないうちは再度のログイン実行は不要です。 認証期限が切れている場合は再度ログインを実行して下さい。
ログイン後、問題ページのテストケースをダウンロードします。
ダウンロードしたい問題ページを開き、URLを確認、もしくはコピーして以下のコマンドを実行して下さい。
rlr download "https://recursionist.io/dashboard/problems/1"
# もしくは
rlr d "https://recursionist.io/dashboard/problems/1"ダウンロードされると、problem-問題番号の名前でディレクトリを作成し、その中にテストケースを記載したファイルのtestcaseディレクトリが作成されます。
└── problem-1
└── testcase
├── testcase-1.in
├── testcase-1.out
├── testcase-2.in
├── testcase-2.out
├── testcase-3.in
├── testcase-3.out
├── testcase-4.in
├── testcase-4.out
├── testcase-5.in
└── testcase-5.outNOTE:
templateディレクトリが配置されている場合、その中身も一緒にコピーしてくれます。 解きたい言語のテンプレートファイルなどを用意して置くと、毎回ファイル作成して環境を構築する手間が省けます。templateの例を含め、環境構築の方法については各言語でのrlrの使い方に、言語毎の例が記載されていますので、参照して下さい。
好きなエディタを用いて、問題を解くコードを記載して下さい。
初心者の方向けに、問題の解き方で基礎となる考え方を記載しました。
詳細は問題の解き方を参照して下さい。
問題を解くコードを記載したら、テストケースを用いてジャッジを行います。
ジャッジを実行するには、ダウンロードしたテストケース(problem-1)が存在するディレクトリで、judgeコマンドを使用する必要があります。
└── problem-1 # <- このディレクトリに移動して実行する。
└── testcase
├── testcase-1.in
├── testcase-1.out
├── testcase-2.in
├── testcase-2.out
├── testcase-3.in
├── testcase-3.out
├── testcase-4.in
├── testcase-4.out
├── testcase-5.in
└── testcase-5.out具体的には、problem-1ディレクトリに移動してからjudgeコマンドを実行すると良いでしょう。
# problem-1の例
cd problem-1judegeコマンドは以下のような構造になっています。
# <command>はシェルで実行可能なコマンドを実行して下さい。
rlr judge "<command>"指定できるコマンドは、シェルやコマンドプロンプトで実行できるコマンドを指定して下さい。
例えば、pythonコードをmain.pyに記載した場合は、以下のようなcommandを指定して下さい。
# pythonの例。main.pyの実行を行う。
rlr judge "python3 main.py"NOTE: 指定する
commandは必ず文字列である必要があります。""で囲って下さい。
NOTE:
rlrは、inputとなるテストケースを標準入力で受け取り、judgeで指定したcommandに対してパイプ処理で受け渡して処理した後、標準出力をoutputのケースと比較します。 つまり、標準入力を受け取って出力可能なcommandなら何でも使えます。手元で実行ができるならどんな言語でも大丈夫ということです。
処理が実行され、各テストケースの結果が表示されます。
コマンドを忘れたら、helpコマンドを実行して下さい。
NOTE: 他のコマンドと違って、
-が頭につくことに注意して下さい。
rlr -h
# 詳細なhelp
rlr --help当リポジトリは、皆さんからのフィードバックをお待ちしています。
rlrはまだ作成されたばかりの未熟なアプリです。 そのため、ぜひ、皆さんのフィードバックをいただければと考えています。
- 使い勝手で改善してほしい部分,
- 欲しい機能,
などがあればissueを投げて下さい。
また、ツールとして最低限動く部分については作成しましたが、実際に各言語でどの様に実行するか、といったところのドキュメントが未整備となっています。
現在、いくつかの言語の例は追加していますが、Recursion側がサポートしている言語のドキュメントも未整備の状態です。
また、自分の好きな言語での解き方ドキュメントも歓迎しています。
手元で実行さえできればどんな言語でも大丈夫です(COBOL, FORTRAN, zig, Hasklell, brainf*ck, etc...)。
ご協力いただける方は、ぜひドキュメント追加のPull Requestを投げて下さい。
「チーム開発参加怖いけど、PRの練習をしたい！」というかつての私のような方でも歓迎しています。
Pull Requestの出し方についてもまとめましたので、ご協力いただける方は以下のドキュメントをご参照下さい。
rlrは oj に、インスパイアされて作成しています。
This project is licensed under the MIT License.