NUnit ベストプラクティス

NUnit を使用した効果的なユニットテストの作成をサポートします。標準的なテストとデータ駆動テストの両方のアプローチに対応しています。

プロジェクトセットup

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

テスト構造

• テストクラスに [TestFixture] 属性を適用
• テストメソッドに [Test] 属性を使用
• Arrange-Act-Assert（AAA）パターンに従う
• MethodName_Scenario_ExpectedBehavior というパターンでテストを命名
• テスト毎のセットアップとティアダウンには [SetUp] と [TearDown] を使用
• クラス毎のセットアップとティアダウンには [OneTimeSetUp] と [OneTimeTearDown] を使用
• アセンブリレベルのセットアップとティアダウンには [SetUpFixture] を使用

標準テスト

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

データ駆動テスト

• インラインテストデータには [TestCase] を使用
• プログラムで生成されたテストデータには [TestCaseSource] を使用
• 単純なパラメータ組み合わせには [Values] を使用
• プロパティまたはメソッドベースのデータソースには [ValueSource] を使用
• ランダムな数値テスト値には [Random] を使用
• 連続した数値テスト値には [Range] を使用
• 複数のパラメータを組み合わせるには [Combinatorial] または [Pairwise] を使用

アサーション

• 制約モデルを使用した Assert.That を使用（推奨される NUnit スタイル）
• Is.EqualTo、Is.SameAs、Contains.Item のような制約を使用
• 単純な値の等値性には Assert.AreEqual を使用（クラシックスタイル）
• コレクション比較には CollectionAssert を使用
• 文字列固有のアサーションには StringAssert を使用
• 例外をテストするには Assert.Throws<T> または Assert.ThrowsAsync<T> を使用
• 失敗時の明確性のため、アサーションには説明的なメッセージを使用

モッキングと分離

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

テスト組織

• 機能またはコンポーネント毎にテストをグループ化
• [Category("CategoryName")] でカテゴリを使用
• 必要に応じて [Order] を使用してテスト実行順序を制御
• [Author("DeveloperName")] を使用して所有権を示す
• [Description] を使用して追加のテスト情報を提供
• 自動実行されてはいけないテストには [Explicit] を検討
• 一時的にテストをスキップするには [Ignore("Reason")] を使用