プロジェクトを生成する

TODO このページは書きかけです。

まずは AtCoder サーバーと同じ環境のプロジェクトを手元に準備します。

まずは、今から参加するコンテストのソースコードを置くフォルダを準備してください。

(TODO: フォルダを作成してそこに cd する方法を説明する)

では、実際にプロジェクトを生成していきます。

cargo-generate をインストールしている場合

cargo generate コマンドをインストールしている場合は、次のようにコマンドを実行してプロジェクト名を入力すれば AtCoder での環境と同様の環境のプロジェクトが生成できます。

$ cargo generate --git https://github.com/rust-lang-ja/atcoder-rust-base --branch ja
Project Name: abc000
Creating project called `abc000`...
Done! New project created /path/to/project/abc000

これで表示されているパスにプロジェクトが生成されました。

Note: ここで生成されるプロジェクトはサンプルとして AtCoder Beginner Contest 086 C - Traveling の解答例とサンプルケースのテスト方法例が書かれてます。テンプレートを自分向けにカスタマイズしたい場合は、リポジトリをフォークするなどして編集し、それを URL に指定して生成させることもできます。

cargo-generate をインストールしていない場合

まずは空のプロジェクトを作成します。

$ cargo init abc000
     Created binary (application) package

そして abc000/Cargo.toml の [dependencies] 以下に AtCoder で利用できるライブラリを追加してください。 atcoder-rust-base の ja ブランチ に含まれている Cargo.toml の雛形を参考にできます。ただしこれは cargo-generate 用の雛形のためプロジェクト名など一部の項目がプレースホルダになっており、そのまま使えるものではないことに注意が必要です。もし完全な形の Cargo.toml をお探しなら、 ja-all-enabled ブランチ に有効な形の Cargo.toml が含まれていますので、こちらを利用することもできます。

また、 Rustup を利用している場合、プロジェクトディレクトリに rust-toolchain というファイルを置いて中身に 1.42.0 とだけ書いておくと、 cargo などのツールを呼び出したときに自動的に Rust 1.42.0 のツールチェインを利用してくれます。もしそのツールチェインがインストールされていなければ自動でダウンロードが始まり、インストールされます。この先しばらくして Rust のバージョンアップが進み、再び AtCoder 側のバージョンとの乖離が大きくなってきたときは、間違って 1.43 以降にしか存在しない機能を利用してしまって Compilation Error を受けないためにも強制的に 1.42.0 を利用させるのが便利です。