XUnit ベストプラクティス

XUnit を使用した効果的なユニットテストの作成方法をお手伝いします。標準的なテストとデータドリブンテストの両方のアプローチに対応しています。

プロジェクトセットアップ

• テストプロジェクトは [ProjectName].Tests という命名規則を使用して分離する
• Microsoft.NET.Test.Sdk、xunit、xunit.runner.visualstudio パッケージを参照する
• テスト対象のクラスに合わせたテストクラスを作成する（例：Calculator に対して CalculatorTests）
• .NET SDK テストコマンドを使用する：テスト実行には dotnet test を使用

テスト構造

• テストクラス属性は不要（MSTest/NUnit とは異なる）
• シンプルなテストには [Fact] 属性を使用してファクトベースのテストを作成する
• Arrange-Act-Assert (AAA) パターンに従う
• MethodName_Scenario_ExpectedBehavior パターンを使用してテストに名前を付ける
• セットアップはコンストラクタで、テアダウンは IDisposable.Dispose() で行う
• IClassFixture<T> を使用してクラス内のテスト間で共有コンテキストを設定する
• ICollectionFixture<T> を使用して複数のテストクラス間で共有コンテキストを設定する

標準テスト

• 1つのテストメソッドで1つの動作に焦点を当てる
• 1つのテストメソッドで複数の動作をテストしない
• インテントを表現した明確なアサーションを使用する
• テストケースを検証するために必要なアサーションのみを含める
• テストを独立させ、べき等にする（どの順序で実行しても同じ結果）
• テスト間の依存関係を避ける

データドリブンテスト

• [Theory] をデータソース属性と組み合わせて使用する
• インラインテストデータには [InlineData] を使用する
• メソッドベースのテストデータには [MemberData] を使用する
• クラスベースのテストデータには [ClassData] を使用する
• DataAttribute を実装してカスタムデータ属性を作成する
• データドリブンテストでは意味のあるパラメータ名を使用する

アサーション

• 値の等価性には Assert.Equal を使用する
• 参照の等価性には Assert.Same を使用する
• ブール条件には Assert.True/Assert.False を使用する
• コレクションには Assert.Contains/Assert.DoesNotContain を使用する
• 正規表現パターンマッチングには Assert.Matches/Assert.DoesNotMatch を使用する
• 例外をテストするには Assert.Throws<T> または await Assert.ThrowsAsync<T> を使用する
• より読みやすいアサーションには fluent assertions ライブラリの使用を検討する

モッキングと分離

• XUnit と共に Moq または NSubstitute の使用を検討する
• テスト対象のユニットを分離するため依存関係をモックする
• モッキングを容易にするためにインターフェースを使用する
• 複雑なテストセットアップには DI コンテナの使用を検討する

テスト構成

• フィーチャーまたはコンポーネント別にテストをグループ化する
• 分類には [Trait("Category", "CategoryName")] を使用する
• 共有依存関係のあるテストをグループ化するにはコレクションフィクスチャを使用する
• テスト診断には出力ヘルパー (ITestOutputHelper) の使用を検討する
• Fact/Theory 属性の Skip = "reason" で条件付きにテストをスキップする