dotnet テストと NUnit を使用した Visual Basic .NET Core ライブラリでの単体テスト

[アーティクル]
03/27/2024

このチュートリアルでは、単体テストの概念について学習するためにサンプルソリューションを段階的に構築する対話型のエクスペリエンスを示します。構築済みのソリューションを使用してチュートリアルに従う場合は、開始する前にサンプルコードを参照またはダウンロードしてください。ダウンロード方法については、「サンプルおよびチュートリアル」を参照してください。

この記事では、.NET Core プロジェクトのテストについて説明します。 ASP.NET Core プロジェクトをテストしている場合は、「ASP.NET Core の統合テスト」を参照してください。

前提条件

.NET 8 SDK 以降のバージョン。
ユーザーが選んだテキストエディターまたはコードエディター。

ソースプロジェクトの作成

シェルウィンドウを開きます。ソリューションを保存するための unit-testing-vb-nunit というディレクトリを作成します。この新しいディレクトリ内で、次のコマンドを実行して、クラスライブラリとテストプロジェクト用の新しいソリューションファイルを作成します。

dotnet new sln

次に、PrimeService ディレクトリを作成します。これまでのところ、ファイルの構造は次のアウトラインのようになっています。

/unit-testing-vb-nunit
    unit-testing-vb-nunit.sln
    /PrimeService

PrimeService を現在のディレクトリとし、次のコマンドを実行してソースプロジェクトを作成します。

dotnet new classlib -lang VB

Class1.VB の名前を PrimeService.VB に変更します。 PrimeService クラスのエラーが発生する実装を作成します。

Namespace Prime.Services
    Public Class PrimeService
        Public Function IsPrime(candidate As Integer) As Boolean
            Throw New NotImplementedException("Please create a test first.")
        End Function
    End Class
End Namespace

unit-testing-vb-using-mstest ディレクトリに戻ります。次のコマンドを実行して、クラスライブラリプロジェクトをソリューションに追加します。

dotnet sln add .\PrimeService\PrimeService.vbproj

テストプロジェクトの作成

次に、PrimeService.Tests ディレクトリを作成します。次の一覧はディレクトリ構造を示したものです。

/unit-testing-vb-nunit
    unit-testing-vb-nunit.sln
    /PrimeService
        Source Files
        PrimeService.vbproj
    /PrimeService.Tests

PrimeService.Tests ディレクトリを現在のディレクトリとし、次のコマンドを使用して新しいプロジェクトを作成します。

dotnet new nunit -lang VB

dotnet new コマンドによって、テストライブラリとして NUnit を使用するテストプロジェクトが作成されます。生成されたテンプレートで、PrimeServiceTests.vbproj ファイルのテストランナーが構成されます。

<ItemGroup>
  <PackageReference Include="nunit" Version="4.2.2" />
  <PackageReference Include="NUnit3TestAdapter" Version="4.6.0" />
  <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
</ItemGroup>

Note

.NET 9 より前では、生成されたコードが古いバージョンの NUnit テストフレームワークを参照している可能性があります。 dotnet CLI を使用してパッケージを更新できます。または、PrimeService.Tests.vbproj ファイルを開き、パッケージ参照項目グループのコンテンツを上記のコードに置き換えます。

テストプロジェクトには、単体テストを作成して実行するための、他のパッケージが必要です。前の手順の dotnet new では、NUnit と NUnit のテストアダプターを追加しました。ここで、プロジェクトに別の依存関係として PrimeService クラスライブラリを追加します。 dotnet add reference コマンドを使用する。

dotnet add reference ../PrimeService/PrimeService.vbproj

全体のファイルは GitHub のサンプルリポジトリで確認できます。

ソリューションの最終的なレイアウトは次のようになります。

/unit-testing-vb-nunit
    unit-testing-vb-nunit.sln
    /PrimeService
        Source Files
        PrimeService.vbproj
    /PrimeService.Tests
        Test Source Files
        PrimeService.Tests.vbproj

unit-testing-vb-nunit ディレクトリ内で次のコマンドを実行します。

dotnet sln add .\PrimeService.Tests\PrimeService.Tests.vbproj

最初のテストの作成

失敗するテストを 1 つ作成してそれを合格させる、というプロセスを繰り返します。 PrimeService.Tests ディレクトリ内で、UnitTest1.vb ファイルの名前を PrimeService_IsPrimeShould.VB に変更し、その内容全体を次のコードに置き換えます。

Imports NUnit.Framework

Namespace PrimeService.Tests
    <TestFixture>
    Public Class PrimeService_IsPrimeShould
        Private _primeService As Prime.Services.PrimeService = New Prime.Services.PrimeService()

        <Test>
        Sub IsPrime_InputIs1_ReturnFalse()
            Dim result As Boolean = _primeService.IsPrime(1)

            Assert.That(result, [Is].False, $"1 should not be prime")
        End Sub

    End Class
End Namespace

<TestFixture> 属性は、テストを含むクラスを表します。 <Test> 属性は、テストランナーによって実行されるメソッドを表します。 unit-testing-vb-nunit で dotnet test を実行してテストとクラスライブラリをビルドし、それからテストを実行します。 NUnit テストランナーには、テストを実行するためのプログラムのエントリポイントが含まれています。 dotnet test を実行すると、作成した単体テストプロジェクトを使用してテストランナーが開始されます。

テストが失敗します。実装はまだ作成していません。最も単純な動作のコードを PrimeService クラスに記述して、このテストが成功するようにします。

Public Function IsPrime(candidate As Integer) As Boolean
    If candidate = 1 Then
        Return False
    End If
    Throw New NotImplementedException("Please create a test first.")
End Function

unit-testing-vb-nunit ディレクトリで dotnet test をもう一度実行します。 dotnet test コマンドは PrimeService プロジェクトのビルドを実行してから、PrimeService.Tests プロジェクトのビルドを実行します。両方のプロジェクトをビルドすると、この単一テストが実行されます。成功します。

他の機能の追加

テストが成功したので、他のテストも記述してみましょう。素数に関する、いくつかの単純なケースが他にもあります (0、-1)。 <Test> 属性を使用すると、これらの例を新しいテストとして追加できますが、すぐに煩雑になります。一連の類似のテストを記述できるようになる、他の xUnit 属性があります。 <TestCase> 属性は同じコードを実行するものの、異なる入力引数が含まれる一連のテストを表します。 <TestCase> 属性を使用して、そのような入力の値を指定することができます。

新しいテストを作成する代わりに、この 2 つの属性を活用して、最も小さな素数である 2 未満の複数の値をテストする一連のテストを作成しましょう。

<TestFixture>
Public Class PrimeService_IsPrimeShould
    Private _primeService As Prime.Services.PrimeService = New Prime.Services.PrimeService()

    <TestCase(-1)>
    <TestCase(0)>
    <TestCase(1)>
    Sub IsPrime_ValuesLessThan2_ReturnFalse(value As Integer)
        Dim result As Boolean = _primeService.IsPrime(value)

        Assert.That(result, [Is].False, $"{value} should not be prime")
    End Sub

    <TestCase(2)>
    <TestCase(3)>
    <TestCase(5)>
    <TestCase(7)>
    Public Sub IsPrime_PrimesLessThan10_ReturnTrue(value As Integer)
        Dim result As Boolean = _primeService.IsPrime(value)

        Assert.That(result, [Is].True, $"{value} should be prime")
    End Sub

    <TestCase(4)>
    <TestCase(6)>
    <TestCase(8)>
    <TestCase(9)>
    Public Sub IsPrime_NonPrimesLessThan10_ReturnFalse(value As Integer)
        Dim result As Boolean = _primeService.IsPrime(value)

        Assert.That(result, [Is].False, $"{value} should not be prime")
    End Sub
End Class

dotnet test を実行して、これらの 2 つのテストが失敗したとします。すべてのテストを成功させるために、PrimeServices.cs ファイルで Main メソッドの先頭にある if 句を変更します。

if candidate < 2

他のテスト、理論、コードをメインライブラリに追加して、反復を続けます。テストの最終版ができ、ライブラリの完全な実装が完了しました。

これで、小さなライブラリとそのライブラリの単体テストのセットが構築されました。ソリューションを構築したことで、新しいパッケージとテストの追加が通常のワークフローに組み込まれました。アプリケーションの目標を達成することに時間と労力の多くを割き、集中して取り組みました。

次の方法で共有

dotnet テストと NUnit を使用した Visual Basic .NET Core ライブラリでの単体テスト

前提条件

ソースプロジェクトの作成

テストプロジェクトの作成

最初のテストの作成

他の機能の追加

その他のリソース

次の方法で共有

dotnet テストと NUnit を使用した Visual Basic .NET Core ライブラリでの単体テスト

前提条件

ソース プロジェクトの作成

テスト プロジェクトの作成

最初のテストの作成

他の機能の追加

その他のリソース

ソースプロジェクトの作成

テストプロジェクトの作成