TUnit ベストプラクティス

TUnit を使用して効果的なユニットテストを作成できるようにサポートします。標準的なテストとデータドリブンテストの両方のアプローチをカバーしています。

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

• [ProjectName].Tests という命名規則で別のテストプロジェクトを使用
• TUnit パッケージと流暢なアサーションのための TUnit.Assertions を参照
• テスト対象のクラスに対応するテストクラスを作成（例：Calculator に対して CalculatorTests）
• .NET SDK テストコマンドを使用：テスト実行には dotnet test を使用
• TUnit には .NET 8.0 以上が必要

テスト構造

• テストクラス属性は不要（xUnit/NUnit のような）
• テストメソッドには [Test] 属性を使用（xUnit のような [Fact] ではない）
• Arrange-Act-Assert (AAA) パターンに従う
• MethodName_Scenario_ExpectedBehavior パターンを使用してテストを命名
• ライフサイクルフック: [Before(Test)] はセットアップ用、[After(Test)] はティアダウン用
• [Before(Class)] と [After(Class)] をクラス内テスト間の共有コンテキスト用に使用
• [Before(Assembly)] と [After(Assembly)] をテストクラス間の共有コンテキスト用に使用
• TUnit は [Before(TestSession)] や [After(TestSession)] などの高度なライフサイクルフックをサポート

標準テスト

• テストを単一の動作に焦点を当てて保つ
• 1 つのテストメソッドで複数の動作をテストしない
• await Assert.That() を使用した TUnit の流暢なアサーション構文を使用
• テストケースの検証に必要なアサーションのみを含める
• テストを独立していて冪等性があるようにする（任意の順序で実行可能）
• テスト間の依存関係を避ける（必要な場合は [DependsOn] 属性を使用）

データドリブンテスト

• インラインテストデータには [Arguments] 属性を使用（xUnit の [InlineData] に相当）
• メソッドベースのテストデータには [MethodData] を使用（xUnit の [MemberData] に相当）
• クラスベースのテストデータには [ClassData] を使用
• ITestDataSource を実装してカスタムデータソースを作成
• データドリブンテストではわかりやすいパラメータ名を使用
• 複数の [Arguments] 属性を同じテストメソッドに適用可能

アサーション

• 値の等価性には await Assert.That(value).IsEqualTo(expected) を使用
• 参照の等価性には await Assert.That(value).IsSameReferenceAs(expected) を使用
• ブール条件には await Assert.That(value).IsTrue() または await Assert.That(value).IsFalse() を使用
• コレクションには await Assert.That(collection).Contains(item) または await Assert.That(collection).DoesNotContain(item) を使用
• 正規表現パターンマッチングには await Assert.That(value).Matches(pattern) を使用
• 例外テストには await Assert.That(action).Throws<TException>() または await Assert.That(asyncAction).ThrowsAsync<TException>() を使用
• .And 演算子でアサーションをチェーン：await Assert.That(value).IsNotNull().And.IsEqualTo(expected)
• 代替条件には .Or 演算子を使用：await Assert.That(value).IsEqualTo(1).Or.IsEqualTo(2)
• DateTime と数値の比較で許容差を指定するには .Within(tolerance) を使用
• すべてのアサーションは非同期で、await が必要

高度な機能

• テストを複数回繰り返すには [Repeat(n)] を使用
• 失敗時の自動再試行には [Retry(n)] を使用
• 並列実行の制限を制御するには [ParallelLimit<T>] を使用
• テストを条件付きでスキップするには [Skip("reason")] を使用
• テストの依存関係を作成するには [DependsOn(nameof(OtherTest))] を使用
• テストのタイムアウトを設定するには [Timeout(milliseconds)] を使用
• TUnit のベース属性を拡張してカスタム属性を作成

テスト構成

• 機能またはコンポーネント別にテストをグループ化
• テスト分類には [Category("CategoryName")] を使用
• カスタムテスト名には [DisplayName("Custom Test Name")] を使用
• テスト診断情報には TestContext の使用を検討
• プラットフォーム固有のテストには [WindowsOnly] などの条件付き属性を使用

パフォーマンスと並列実行

• TUnit はデフォルトでテストを並列実行（xUnit は明示的な設定が必要）
• 特定のテストの並列実行を無効にするには [NotInParallel] を使用
• 同時実行を制御するにはカスタムリミットクラスで [ParallelLimit<T>] を使用
• 同じクラス内のテストはデフォルトで順序実行
• ロードテストのシナリオでは [Repeat(n)] と [ParallelLimit<T>] を使用

xUnit からの移行

• [Fact] を [Test] に置き換え
• [Theory] を [Test] に置き換え、データには [Arguments] を使用
• [InlineData] を [Arguments] に置き換え
• [MemberData] を [MethodData] に置き換え
• Assert.Equal を await Assert.That(actual).IsEqualTo(expected) に置き換え
• Assert.True を await Assert.That(condition).IsTrue() に置き換え
• Assert.Throws<T> を await Assert.That(action).Throws<T>() に置き換え
• コンストラクタ/IDisposable を [Before(Test)]/[After(Test)] に置き換え
• IClassFixture<T> を [Before(Class)]/[After(Class)] に置き換え

xUnit より TUnit を選ぶ理由

TUnit は、xUnit にない非同期アサーション、より洗練されたライフサイクルフック、改善されたデータドリブンテスト機能など、高度な機能を備えた最新でファストで柔軟なテスト体験を提供します。TUnit の流暢なアサーションはより明確で表現力の高いテスト検証を提供し、複雑な .NET プロジェクトに特に適しています。