Pengujian unit pustaka Visual Basic .NET menggunakan dotnet test dan TUnit

Tutorial ini membawa Anda melalui pengalaman interaktif membangun solusi sampel langkah demi langkah untuk mempelajari konsep pengujian unit.

Artikel ini berisi tentang menguji proyek .NET Core. Jika Anda menguji proyek ASP.NET Core, lihat pengujian Integrasi di ASP.NET Core.

Prerequisites

  • .NET 10 SDK atau versi yang lebih baru.
  • Editor teks atau editor kode pilihan Anda.

TUnit dibangun sepenuhnya di atas Microsoft.Testing.Platform (MTP) dan tidak mendukung VSTest. Tutorial ini menggunakan mode MTP , dotnet testyang memerlukan .NET 10 SDK.

Membuat proyek sumber

Buka jendela shell. Buat direktori yang disebut unit-testing-vb-tunit untuk menyimpan solusi. Di dalam direktori baru ini, jalankan perintah berikut untuk membuat file solusi baru untuk pustaka kelas dan proyek pengujian:

dotnet new sln

Selanjutnya, buat direktori PrimeService. Kerangka berikut menunjukkan struktur file sejauh ini:

/unit-testing-vb-tunit
    unit-testing-vb-tunit.slnx
    /PrimeService

Jadikan PrimeService sebagai direktori aktif dan jalankan perintah berikut untuk membuat proyek sumber:

dotnet new classlib -lang VB

Ganti nama Class1.vb menjadi PrimeService.vb. Anda membuat implementasi yang gagal dari kelas 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

Ubah direktori kembali ke direktori unit-testing-vb-tunit . Jalankan perintah berikut untuk menambahkan proyek pustaka kelas ke solusi:

dotnet sln add ./PrimeService/PrimeService.vbproj

Membuat proyek pengujian

Selanjutnya, buat direktori PrimeService.Tests. Kerangka berikut menunjukkan struktur direktori:

/unit-testing-vb-tunit
    unit-testing-vb-tunit.slnx
    /PrimeService
        Source Files
        PrimeService.vbproj
    /PrimeService.Tests

Templat proyek TUnit tidak disertakan dalam SDK .NET. Instal semuanya dengan perintah berikut:

dotnet new install TUnit.Templates

Jadikan direktori PrimeService.Tests sebagai direktori saat ini dan buat proyek baru menggunakan perintah berikut:

dotnet new TUnit -lang VB

Note

Nama pendek templat peka huruf besar/kecil. Gunakan TUnit, bukan tunit.

Perintah dotnet new membuat proyek pengujian yang menggunakan TUnit sebagai pustaka pengujian. File PrimeService.Tests.vbproj yang dihasilkan adalah proyek yang dapat dieksekusi yang mereferensikan paket TUnit, yang mencakup kerangka kerja pengujian, pustaka asersi, dan runner pengujian MTP, sehingga proyek tidak memerlukan paket pengujian lain.

Template juga menambahkan contoh pengujian. Hapus semua file .vb dan direktori Data dari direktori PrimeService.Tests , karena tutorial ini menggantinya dengan pengujiannya sendiri.

Sekarang, tambahkan pustaka kelas PrimeService sebagai dependensi lain ke proyek. Gunakan perintah dotnet reference add:

dotnet reference add ../PrimeService/PrimeService.vbproj

Anda memiliki tata letak solusi akhir berikut:

/unit-testing-vb-tunit
    unit-testing-vb-tunit.slnx
    /PrimeService
        Source Files
        PrimeService.vbproj
    /PrimeService.Tests
        Test Source Files
        PrimeService.Tests.vbproj

Jalankan perintah berikut di direktori unit-testing-vb-tunit :

dotnet sln add ./PrimeService.Tests/PrimeService.Tests.vbproj

Mengonfigurasi mode MTP dotnet test

Karena TUnit tidak mendukung VSTest, dotnet test harus berjalan dalam mode MTP-nya. Di direktori unit-testing-vb-tunit , buat file global.json dengan konten berikut:

{
    "test": {
        "runner": "Microsoft.Testing.Platform"
    }
}

Untuk informasi selengkapnya, lihat mode MTP dari dotnet test.

Membuat pengujian pertama

Anda menulis satu pengujian yang gagal, membuatnya lulus, lalu mengulangi prosesnya. Di direktori PrimeService.Tests , buat file PrimeService_IsPrimeShould.vb dengan kode berikut:

Imports TUnit.Assertions
Imports TUnit.Assertions.Extensions
Imports TUnit.Core

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

        <Test>
        Public Async Function IsPrime_InputIs1_ReturnFalse() As Task
            Dim result As Boolean = _primeService.IsPrime(1)

            Await Assert.That(result).IsFalse()
        End Function

    End Class
End Namespace

Atribut <Test> menunjukkan metode yang dijalankan oleh runner pengujian. TUnit tidak memerlukan atribut di kelas . Pernyataan TUnit bersifat asinkron, sehingga pengujian adalah Async Function yang mengembalikan Task dan menunggu Assert.That.

Visual Basic menempatkan kode di setiap proyek di bawah namespace akar proyek, sehingga kelas PrimeService berada dalam namespace PrimeService.Prime.Services. Pengujian ini menyebutnya sebagai Prime.Services.PrimeService karena, di dalam namespace proyek pengujian, namanya PrimeService mengacu pada namespace daripada ke kelas .

Dari direktori unit-testing-vb-tunit, jalankan dotnet test untuk membangun pengujian dan pustaka kelas lalu jalankan pengujian. Proyek pengujian TUnit berisi titik masuk program untuk menjalankan pengujian Anda. dotnet test memulai aplikasi pengujian menggunakan proyek pengujian unit yang telah Anda buat.

Tes anda gagal. Anda belum membuat implementasi. Buat lulus pengujian ini dengan menulis kode paling sederhana di kelas PrimeService yang berfungsi:

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

Di direktori unit-testing-vb-tunit, jalankan dotnet test lagi. Perintah dotnet test menjalankan build untuk proyek PrimeService lalu untuk proyek PrimeService.Tests. Setelah membangun kedua proyek, sistem menjalankan pengujian tunggal ini. Ini berlalu.

Menambahkan lebih banyak fitur

Sekarang setelah Anda menyelesaikan satu kali uji coba, saatnya menulis lebih banyak. Ada beberapa kasus sederhana lainnya untuk bilangan prima: 0, -1. Anda dapat menambahkan kasus-kasus tersebut sebagai pengujian baru dengan atribut <Test>, tetapi itu dengan cepat menjadi melelahkan. TUnit menyediakan <Arguments> atribut untuk membuat serangkaian pengujian yang menjalankan kode yang sama tetapi memiliki argumen input yang berbeda.

Alih-alih membuat pengujian baru, terapkan atribut ini untuk membuat satu pengujian berbasis data. Ganti fungsi IsPrime_InputIs1_ReturnFalse dengan kode berikut, yang menguji beberapa nilai kurang dari dua, bilangan prima terkecil:

<Test>
<Arguments(-1)>
<Arguments(0)>
<Arguments(1)>
Public Async Function IsPrime_ValuesLessThan2_ReturnFalse(value As Integer) As Task
    Dim result As Boolean = _primeService.IsPrime(value)

    Await Assert.That(result).IsFalse()
End Function

Jalankan dotnet test, dan dua pengujian ini gagal. Untuk membuat semua tes lulus, ubah If klausul di awal IsPrime metode dalam file PrimeService.vb :

If candidate < 2 Then

Lanjutkan iterasi dengan menambahkan lebih banyak pengujian dan lebih banyak kode di pustaka utama.

Anda telah membangun perpustakaan kecil dan serangkaian unit pengujian untuk perpustakaan tersebut. Anda telah menyusun solusi sehingga menambahkan paket dan pengujian baru adalah bagian dari alur kerja normal. Anda telah memkonsentasikan sebagian besar waktu dan upaya Anda untuk menyelesaikan tujuan aplikasi.

Baca juga