![\"image-20260531161743127\"](\"C:%5CUsers%5Ckash1064%5CCodes%5Cblog-project%5CKaeru-no-Himitsukichi%5Cstatic%5Cmedia%5C2026-05-31-rust-test%5Cimage-20260531161743127.png\")
今回は Rust のテスト記法に関するメモ書きです。
\n\nRust では標準で以下の 3 つのテスト機能を利用できます。
\n他にもサードパーティーのクレートを追加することで様々なテスト機能を追加することができるようですが、今回は標準で利用可能なテスト方法のうち、主にユニットテストと結合テストを中心に扱うことにします。
\nドキュメントテストは今回は使用しないので割愛します。
\nユニットテストとは、個々の関数やモジュールを単独で検証するテストです。
\nRust の場合は、テスト対象のコードと同じファイル内に #[cfg(test)] モジュールとして配置することで実装できます。
fn internal_helper(x: i32) -> i32 {\n x * 2\n}\n\npub fn public_function(x: i32) -> i32 {\n internal_helper(x) + 1\n}\n\n#[cfg(test)] // cargo test 時のみコンパイルされる\nmod tests {\n use super::*; // 親モジュールの全アイテムをインポート\n\n #[test]\n fn test_internal_helper() {\n // private 関数にも直接アクセスできる\n assert_eq!(internal_helper(5), 10);\n }\n\n #[test]\n fn test_public_function() {\n assert_eq!(public_function(5), 11);\n }\n}シンプルなユニットテストの実装のため、以下の関数を実装します。
\n/// 二つの整数を加算する\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}これに対して、テストモジュールは同じファイルに #[cfg(test)] アノテーションを記述した上で実装します。
参考：Test Organization - The Rust Programming Language
\n#[cfg(test)] アノテーションが記述されたテストモジュールは cargo test を実行したときにだけ Rust によりコンパイル/実行されます。
ユニットテストはプロダクションのソースコードと同じファイルに記載するため、ビルド時に生成物にテストモジュールが含まれないようにするためにも #[cfg(test)] アノテーションを使用しています。(結合テストの場合は別のファイルに記述するため、#[cfg(test)] アノテーションは不要です。)
#[cfg(test)]\nmod tests {\n\n use super::*;\n\n #[test]\n fn test_add_basic() {\n let result = add(2, 3);\n assert!(result == 5);\n }\n\n}このようなテストモジュールについては cargo test もしくは cargo test <テスト関数> でテストを実行できます。
例えば上記の例では、cargo test test_add_basic を実行することで add 関数のテストに成功することを確認できます。
Rust のユニットテストでは、標準の assert! マクロにより評価を行うことができます。
\n例えば、以下の 3 つの関数をテスト用に作成します。
\n/// 二つの整数を加算する\npub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n\n/// 二つの整数を乗算する\npub fn multiply(a: i32, b: i32) -> i32 {\n a * b\n}\n\n/// 文字列が空かどうかを判定する\npub fn is_empty(s: &str) -> bool {\n s.is_empty()\n}これらの関数の挙動をテストするため、いくつかのテスト関数をそれぞれ使用できます。
\nまず以下の関数は、assert! マクロを使用して add(2, 3) が 5 となるかを検証します。
assert! は条件が true であることを検証できます。
#[test]\nfn test_add_basic() {\n let result = add(2, 3);\n assert!(result == 5);\n}assert! マクロではテスト失敗時のテキストを定義することもできます。
#[test]\nfn test_add_with_text() {\n let result = add(2, 3);\n assert!(result == 5,\"2 + 3 = 5 ですが、実際の結果は {} でした。\",result);\n}上記のテストに失敗した場合、以下のようなテキストを表示できます。
\n![\"image-20260531163634374\"](\"C:%5CUsers%5Ckash1064%5CCodes%5Cblog-project%5CKaeru-no-Himitsukichi%5Cstatic%5Cmedia%5C2026-05-31-rust-test%5Cimage-20260531163634374.png\")
また、assert_eq! というマクロを使用することもできます。
このマクロでは、パラメータとして与えられた 2 つの要素の値が一致することを確認できます。
\n#[test]\nfn test_add_with_assert_eq() {\n assert_eq!(add(2, 3), 5);\n assert_eq!(add(0, 0), 0);\n assert_eq!(add(-1, 1), 0);\n}逆に、assert_ne! マクロは 2 つの要素が一致しないことを確認することができます。
以下の例の場合には、multiply(3, 4) の実行結果が 12 となるため、2 つめのパラメータが 12 の場合にテストに失敗します。
#[test]\nfn test_multiply_not_zero() {\n assert_ne!(multiply(3, 4), 0);\n}また、テスト関数は通常の関数のように使用できるため、以下のように変数の宣言などをテストに含めることもできます。
\n#[test]\nfn test_with_setup() {\n let input_a = 100;\n let input_b = 200;\n let actual = add(input_a, input_b);\n\n assert_eq!(actual, input_a + input_b);\n}次に、カスタム構造体 Point を使用した以下のようなシンプルなコードを実装します。
\nuse std::fmt;\n\npub struct Point {\n pub x: f64,\n pub y: f64,\n}\n\nimpl Point {\n pub fn new(x: f64, y: f64) -> Self {\n Self { x, y }\n }\n\n pub fn origin() -> Self {\n Self { x: 0.0, y: 0.0 }\n }\n\n pub fn distance_from_origin(&self) -> f64 {\n (self.x * self.x + self.y * self.y).sqrt()\n }\n \n}\n\nimpl fmt::Display for Point {\n fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {\n write!(f, \"({}, {})\", self.x, self.y)\n }\n}\n\nfn main() {\n\n // new を使って Point を作成\n let p1 = Point::new(3.0, 4.0);\n println!(\"p1 の座標 = {}\", p1);\n\n // origin を使って原点を作成\n let origin = Point::origin();\n println!(\"原点の座標 = {}\", origin);\n\n\n // distance_from_origin を使って原点からの距離を計算\n let distance = p1.distance_from_origin();\n println!(\"p1 の原点からの距離 = {}\", distance);\n\n println!(\"\\n\");\n}このコードに対して、例えば以下のようにユニットテスト内でロードしたカスタム構造体 Point を使用することができます。
\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_main_ne_custom_struct() {\n let p = Point::new(1.0, 1.0);\n assert_ne!(p, Point::origin());\n }\n\n}ただし、このコードで上記のテストを実行すると、assert_ne! の依存関係にある Debug や PartialEq の実装が存在しないためテストがエラーとなってしまいます。
![\"image-20260531224028164\"](\"C:%5CUsers%5Ckash1064%5CCodes%5Cblog-project%5CKaeru-no-Himitsukichi%5Cstatic%5Cmedia%5C2026-05-31-rust-test%5Cimage-20260531224028164.png\")
このように assert_ne! などのマクロをカスタム構造体のテストに使用する場合は、構造体に #[derive(Debug,PartialEq)] を付けて実装を導出しておく必要があります。
ここまではテスト関数内でパニックが発生した場合にテストが失敗していましたが、意図的にパニックを発生させたい関数について、「適切にパニックが発生するか」をテストすることもできます。
\n例えば、以下のような 0 除算が発生した場合に panic をトリガーする除算関数をテストするとします。
\npub fn divide(a: i32, b: i32) -> i32 {\n if b == 0 {\n panic!(\"ゼロで除算することはできません: {} / {}\", a, b);\n }\n a / b\n}この場合には、以下のように #[should_panic] アトリビュートをテスト関数に付与します。
#[test]\n#[should_panic]\nfn test_divide_by_zero_panics() {\n divide(10, 0); // パニックするので、テストは成功\n}このテストが実行された場合には、0 除算によるパニックが発生すればテストが成功となり、逆にパニックが発生せず divide 関数による除算が成功するとテストは失敗となります。
\n参考：Unit testing - Rust By Example
\nまた、#[should_panic(expected = \"message\")] のようにパニック発生時のメッセージをアトリビュートで指定することもできます。
以下はドキュメントのサンプルのそのまま引用ですが、#[ignore] アトリビュートを記述することで、特定のテスト関数を cargo test 時に実行させないようにすることができます。
このような除外されたテストについては cargo test -- --ignored で実行することができます。
pub fn add(a: i32, b: i32) -> i32 {\n a + b\n}\n\n#[cfg(test)]\nmod tests {\n use super::*;\n\n #[test]\n fn test_add() {\n assert_eq!(add(2, 2), 4);\n }\n\n #[test]\n fn test_add_hundred() {\n assert_eq!(add(100, 2), 102);\n assert_eq!(add(2, 100), 102);\n }\n\n #[test]\n #[ignore]\n fn ignored_test() {\n assert_eq!(add(0, 0), 0);\n }\n}Rust のテストは、デフォルトでは複数スレッドで並列実行されるようです。
\nそのため、複数のテスト間でファイルや DB などのリソースを共有する必要がある場合には適切に Mutex などによりリソースを保護するなどの注意が必要です。
\nテスト時の並列実行を無効化したい場合は cargo test -- --test-threads=1 を使用できます。
参考：テストの実行のされ方を制御する - The Rust Programming Language 日本語版
\nまた、テストの実行順序は保証されていないため、複数のテスト間に依存関係が発生しないように注意する必要があります。
\nRust の結合テストは、クレートの外側から、ユーザーと同じ視点でプログラムの公開されたインターフェースのみを使用してテストを行います。
\n結合テストは、ライブラリの各モジュールの連携が正しく動作するかをテストする目的で行われます。
\nCargo は、以下のように src ディレクトリと並んで配置された tests ディレクトリを結合テストとして扱います。
\nmy_project/\n├── Cargo.toml\n├── src/\n│ ├── lib.rs # ライブラリ本体\n│ └── utils.rs\n└── tests/ # 結合テスト専用ディレクトリ\n ├── api_test.rs # 個別のテストファイル（各自が独立クレート）\n ├── edge_cases.rs\n └── common/ # テスト共有ユーティリティ\n └── mod.rs # mod.rs にすることでテストファイルと認識されないため、テスト用のヘルパーコードを配置できる参考：インテグレーションテスト - Rust By Example 日本語版
\n今回は、Claude に適当に作らせた電卓ライブラリに対する結合テストを作成します。
\nクライアントプログラムからこのライブラリを使用する場合、アプリケーションは rust_integration_test_samples クレートの各種モジュールを以下のようにインポートする必要があります。
use rust_integration_test_samples::calculator::Calculator;\nuse rust_integration_test_samples::storage::{Storage, StorageValue};\nuse rust_integration_test_samples::user::{Role, UserService};これは、結合テストを行うテストコードについても同様で、テストコード側でもクライアントプログラムを実装する場合と同じく外部からライブラリを利用するためにモジュールのインポートを行う必要があります。
\n以下は最もシンプルな結合テストの実装です。
\n以下では、クライアントプログラムと同様にライブラリの Calculator モジュールをインポートし、test_calculator_basic_operations というテスト関数で add や subtract、multiply などの関数の戻り値をテストしています。
use rust_integration_test_samples::calculator::Calculator;\n\n#[test]\nfn test_calculator_basic_operations() {\n let mut calc = Calculator::new();\n\n assert_eq!(calc.add(2.0, 3.0), 5.0);\n assert_eq!(calc.subtract(10.0, 4.0), 6.0);\n assert_eq!(calc.multiply(3.0, 7.0), 21.0);\n}このテストコードは、tests 配下に配置したファイルに記述します。
\nmy_project/\n├── Cargo.toml\n├── src/\n│ ├── lib.rs # ライブラリ本体\n│ └── utils.rs\n└── tests/ # 結合テスト専用ディレクトリ\n └── api_test.rs # 個別のテストファイル（各自が独立クレート）同じテストコード内で、以下のように正常系や異常系のテストを行うこともできます。
\n/// 除算のテスト（正常系）\n#[test]\nfn test_calculator_division() {\n let mut calc = Calculator::new();\n\n let result = calc.divide(10.0, 2.0);\n assert_eq!(result, Ok(5.0));\n}\n\n/// 除算のテスト（エラー系：ゼロ除算）\n#[test]\nfn test_calculator_division_by_zero() {\n let mut calc = Calculator::new();\n\n let result = calc.divide(10.0, 0.0);\n assert_eq!(result, Err(CalcError::DivisionByZero));\n}ライブラリ側の divide 関数は以下のように実装されており戻り値として Result<f64, CalcError> を返すため、結合テスト側のテストコードでも assert_eq!(result, Ok(5.0)); や assert_eq!(result, Err(CalcError::DivisionByZero)); による結果の評価を行っています。
pub fn divide(&mut self, a: f64, b: f64) -> Result<f64, CalcError> {\n if b == 0.0 {\n return Err(CalcError::DivisionByZero);\n }\n let result = a / b;\n self.record(format!(\"{} / {}\", a, b), result);\n Ok(result)\n}結合テストでは、ユーザーがクライアントプログラムを操作した場合と同じように一連の操作後の状態を順にテストすることもできます。
\n例えば以下の例では、ライブラリ側で管理する計算履歴の情報に対して、計算の実行後や履歴のクリア後のカウント数をテストしたり、履歴のテスト後も計算を継続することが可能であることを確認するテストを実装しています。
\n#[test]\nfn test_calculator_history_management() {\n let mut calc = Calculator::new();\n\n // 初期状態\n assert_eq!(calc.history().len(), 0);\n\n // 操作を実行\n calc.add(1.0, 2.0);\n calc.multiply(3.0, 4.0);\n assert_eq!(calc.history().len(), 2);\n\n // 履歴クリア\n calc.clear_history();\n assert_eq!(calc.history().len(), 0);\n\n // クリア後も操作は可能\n calc.add(5.0, 6.0);\n assert_eq!(calc.history().len(), 1);\n}ユニットテストや結合テストにはもっと色々な記法があり、より複雑なテストの実装も可能なようですが、とりあえず今回はここまでにします。
\n最近は AI 使ってばっかりなのでもっとテストをガリガリ書けるようになりたいですね。
","fields":{"slug":"/rust-test","tagSlugs":["/tag/rust/"]},"frontmatter":{"date":"2026-06-01","description":"Rust のエラーハンドリングと thiserror に関するメモ書きです。","tags":["Rust"],"title":"Rust のエラーハンドリングと thiserror に関するメモ書き","socialImage":{"publicURL":"/static/42a86ef0996119572315112587f870d4/rust-test.png"}}}},"pageContext":{"slug":"/rust-test"}},"staticQueryHashes":["251939775","401334301","825871152"]}