第35回です。前回はこちら。

kdnakt.hatenablog.com

 

• [第35回の様子]
• [学んだこと]
• [まとめ]

 

[第35回の様子]

2022/04/13に第35回を開催した。

 

内容としてはRust By Example 日本語版の「12. Cargo」、「12.1. Dependencies」、「12.2. Conventions」、「12.3. Tests」に取り組んだ。

 

参加者は6人ほど。

 

 

[学んだこと]

• 12. Cargo
• Rustのパッケージ管理ツールはcargoというのがある
• 依存関係管理、ユニットテスト実行、ベンチマーク取得などができる
• 詳細は以下のサイト

doc.rust-lang.org

• 12.1. Dependencies
• まずはプロジェクト作成

$ cargo new foo
$ tree foo
foo
├── Cargo.toml
└── src
    └── main.rs

1 directory, 2 files

• 次に依存関係管理：cargo.tmlのdependencies欄に以下のように書く

[package]
name = "foo"
version = "0.1.0"
edition = "2021"

[dependencies]
clap = "2.27.1" // CLI用のライブラリ

• 依存関係は以下のようにリポジトリから直接、あるいはローカルのディレクトリを指定できる

// オンラインのリポジトリから取得
rand = { git = "https://github.com/rust-lang-nursery/rand" }

// ローカルのディレクトリから取得
bar = { path = "../bar" }

• Javaのmavenやgradleはルートディレクトリで実行するのが普通だが、cargoはプロジェクトのどのディレクトリでもビルドや実行ができるらしい。すごい
• 12.2. Conventions
• 同じプロジェクトで別のバイナリを作りたい時は以下のようにする

$ tree foo
foo
├── Cargo.toml
└── src
    ├── main.rs
    └── bin      // binディレクトリを追加
        └── my_other_bin.rs // バイナリにしたい.rsファイル

• このバイナリをビルドするときはcargo build --bin my_pther_binのようにする
• 12.3. Tests
• Rustではユニットテストはモジュールのファイル内に記載する
• が、ここではそれとは別の結合テストの書き方を学ぶ
• 以下のようにtestsディレクトリを作って、そこに結合テストを配置する

$ tree foo
foo
├── Cargo.toml
├── src
│   └── main.rs
│   └── lib.rs
└── tests // ここに結合テスト
    ├── my_test.rs
    └── my_other_test.rs

• cargo testコマンドで結合テストも実行できる
• cargo test (プレフィクス)で特定の名前で始まるテストのみ実行できる
• cargoのテスト実行は並列なので、以下のようなテストは注意が必要

// 同じファイルにテキストを出力する2つのテスト
#[cfg(test)]
mod tests {
    // Import the necessary modules
    use std::fs::OpenOptions;
    use std::io::Write;

    // This test writes to a file
    #[test]
    fn test_file() {
        // Opens the file ferris.txt or creates one if it doesn't exist.
        let mut file = OpenOptions::new()
            .append(true)
            .create(true)
            .open("ferris.txt")
            .expect("Failed to open ferris.txt");

        // Print "Ferris" 5 times.
        for _ in 0..5 {
            file.write_all("Ferris\n".as_bytes())
                .expect("Could not write to ferris.txt");
        }
    }

    // This test tries to write to the same file
    #[test]
    fn test_file_also() {
        // Opens the file ferris.txt or creates one if it doesn't exist.
        let mut file = OpenOptions::new()
            .append(true)
            .create(true)
            .open("ferris.txt")
            .expect("Failed to open ferris.txt");

        // Print "Corro" 5 times.
        for _ in 0..5 {
            file.write_all("Corro\n".as_bytes())
                .expect("Could not write to ferris.txt");
        }
    }
}

 

[まとめ]

モブプログラミングスタイルでRust dojoを開催した。

rustcだけで頑張っていた先週と比べて、cargoのおかげで楽に依存関係が管理できるようになった。便利〜。

 

今週のプルリクエストはこちら。

github.com