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

[アーティクル]
04/08/2023

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

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

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

シェルウィンドウを開きます。ソリューションを保存するための unit-testing-vb-mstest というディレクトリを作成します。この新しいディレクトリ内で dotnet new sln を実行して、ソリューションを新たに作成します。こうすることで、クラスライブラリと単体テストプロジェクトの両方を管理しやすくなります。ソリューションのディレクトリ内で、PrimeService ディレクトリを作成します。現時点のディレクトリとファイルの構造は次のようになっています。

/unit-testing-vb-mstest
    unit-testing-vb-mstest.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-mstest
    unit-testing-vb-mstest.sln
    /PrimeService
        Source Files
        PrimeService.vbproj
    /PrimeService.Tests

PrimeService.Tests ディレクトリを現在のディレクトリにします。それから dotnet new mstest -lang VB を利用して新しいプロジェクトを作成します。このコマンドによって、テストライブラリとして MSTest を使用するテストプロジェクトが作成されます。生成されたテンプレートで、PrimeServiceTests.vbproj のテストランナーが構成されます。

<ItemGroup>
  <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.5.0" />
  <PackageReference Include="MSTest.TestAdapter" Version="1.1.18" />
  <PackageReference Include="MSTest.TestFramework" Version="1.1.18" />
</ItemGroup>

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

dotnet add reference ../PrimeService/PrimeService.vbproj

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

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

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

unit-testing-vb-mstest ディレクトリで dotnet sln add .\PrimeService.Tests\PrimeService.Tests.vbproj を実行します。

最初のテストの作成

失敗するテストを 1 つ作成してそれを合格させる、というプロセスを繰り返します。 PrimeService.Tests ディレクトリから UnitTest1.vb を削除し、PrimeService_IsPrimeShould.VB という名前の新しい Visual Basic ファイルを作成します。次のコードを追加します。

Imports Microsoft.VisualStudio.TestTools.UnitTesting

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

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

            Assert.IsFalse(result, "1 should not be prime")
        End Sub

    End Class
End Namespace

<TestClass> 属性は、テストを含むクラスを表します。 <TestMethod> 属性は、テストランナーによって実行されるメソッドを表します。 unit-testing-vb-mstest で dotnet test を実行してテストとクラスライブラリをビルドし、それからテストを実行します。 MSTest テストランナーには、テストを実行するためのプログラムのエントリポイントが含まれています。 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-mstest ディレクトリで、もう一度 dotnet test を実行します。 dotnet test コマンドは PrimeService プロジェクトのビルドを実行してから、PrimeService.Tests プロジェクトのビルドを実行します。両方のプロジェクトをビルドすると、この単一テストが実行されます。成功します。

他の機能の追加

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

新しいテストを作成するのではなく、この 2 つの属性を適用することで 1 つの理論を作成できます。その理論とは、複数の 2 未満の値を調べて、もっとも小さい素数を特定するという手法です。

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

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

        Assert.IsFalse(result, $"{value} should not be prime")
    End Sub

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

        Assert.IsTrue(result, $"{value} should be prime")
    End Sub

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

        Assert.IsFalse(result, $"{value} should not be prime")
    End Sub
End Class

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

if candidate < 2

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

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

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

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

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

最初のテストの作成

他の機能の追加

フィードバック

その他のリソース

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

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

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

最初のテストの作成

他の機能の追加

フィードバック

その他のリソース

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

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