Testes unitários de bibliotecas Visual Basic .NET usando dotnet test e TUnit

Este tutorial leva você através de uma experiência interativa criando uma solução de exemplo passo a passo para aprender conceitos de teste de unidade.

Este artigo é sobre como testar um projeto .NET Core. Se você estiver testando um projeto ASP.NET Core, consulte Testes de integração no ASP.NET Core.

Prerequisites

  • .NET 10 SDK ou versões posteriores.
  • Um editor de texto ou editor de código da sua preferência.

O TUnit assenta inteiramente em Microsoft.Testing.Platform (MTP) e não suporta VSTest. Este tutorial utiliza o modo MTP de dotnet test, que requer o SDK .NET 10.

Criando o projeto de origem

Abra uma janela de terminal. Crie um diretório chamado unit-testing-vb-tunit para armazenar a solução. Dentro desse novo diretório, execute o seguinte comando para criar um novo arquivo de solução para a biblioteca de classes e o projeto de teste:

dotnet new sln

Em seguida, crie um diretório PrimeService. O esquema a seguir mostra a estrutura do arquivo até agora.

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

Faça PrimeService o diretório atual e execute o seguinte comando para criar o projeto de origem:

dotnet new classlib -lang VB

Renomeie Class1.vb para PrimeService.vb. Você cria uma implementação com falha da classe 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

Mude o diretório de volta para o diretório unit-testing-vb-tunit. Execute o seguinte comando para adicionar o projeto de biblioteca de classes à solução:

dotnet sln add ./PrimeService/PrimeService.vbproj

Criando o projeto de teste

Em seguida, crie o diretório PrimeService.Tests. O esquema a seguir mostra a estrutura de diretórios:

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

Os modelos de projeto TUnit não estão incluídos no SDK .NET. Instale-os com o seguinte comando:

dotnet new install TUnit.Templates

Torne o diretório PrimeService.Tests o diretório atual e crie um novo projeto usando o seguinte comando:

dotnet new TUnit -lang VB

Note

Os nomes curtos do modelo são sensíveis a maiúsculas e minúsculas. Use TUnit, não tunit.

O comando dotnet new cria um projeto de teste que usa o TUnit como biblioteca de teste. O ficheiro PrimeService.Tests.vbproj gerado é um projeto executável que faz referência ao pacote TUnit, incluindo o framework de teste, a biblioteca de asserção e o executor de testes MTP, pelo que o projeto não precisa de outros pacotes de teste.

O modelo também adiciona testes de exemplo. Apaga todos os ficheiros .vb e o diretório Data do diretório PrimeService.Tests, porque este tutorial substitui-os pelos seus próprios testes.

Agora, adicione a biblioteca de classes PrimeService como outra dependência ao projeto. Utilize o comando dotnet reference add:

dotnet reference add ../PrimeService/PrimeService.vbproj

Você tem o seguinte layout de solução final:

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

Execute o seguinte comando no diretório unit-testing-vb-tunit :

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

Configuração do modo MTP do dotnet test

Como o TUnit não suporta VSTest, dotnet test tem de correr no seu modo MTP. No diretório unit-testing-vb-tunit , crie um ficheiro global.json com o seguinte conteúdo:

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

Para mais informações, veja o modo MTP do dotnet test.

Criando o primeiro teste

Escreve um teste que falha, faz com que passe, depois repete o processo. No diretório PrimeService.Tests , crie um ficheiro PrimeService_IsPrimeShould.vb com o seguinte código:

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

O atributo <Test> indica um método que é executado pelo executor de teste. O TUnit não precisa de um atributo na classe. As asserções TUnit são assíncronas, por isso o teste é um Async Function que retorna a Task e aguarda Assert.That.

O Visual Basic coloca o código em cada projeto no namespace raiz do projeto, por isso a PrimeService classe fica no PrimeService.Prime.Services namespace. O teste refere-se-lhe como Prime.Services.PrimeService porque, dentro dos namespaces do projeto de teste, o nome PrimeService refere-se a um namespace em vez da classe.

A partir do diretório unit-testing-vb-tunit , execute dotnet test para construir os testes e a biblioteca de classes e depois execute os testes. O projeto de teste TUnit contém o ponto de entrada do programa para executar os seus testes. dotnet test Inicia a aplicação de teste usando o projeto de teste unitário que criaste.

O seu teste falha. Você ainda não criou a implementação. Faça este teste passar escrevendo o código mais simples na classe PrimeService que funciona:

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

No diretório unit-testing-vb-tunit , execute dotnet test novamente. O comando dotnet test executa uma compilação para o projeto PrimeService e, em seguida, para o projeto PrimeService.Tests. Depois de compilar ambos os projetos, ele executa este teste único. Passa.

Adicionando mais recursos

Agora que você fez um teste aprovado, é hora de escrever mais. Existem alguns outros casos simples para números primos: 0, -1. Você pode adicionar esses casos como novos testes com o atributo <Test>, mas isso rapidamente se torna tedioso. O TUnit fornece o <Arguments> atributo para criar um conjunto de testes que executam o mesmo código mas têm argumentos de entrada diferentes.

Em vez de criar novos testes, aplique esse atributo para criar um único teste controlado por dados. Substitua a IsPrime_InputIs1_ReturnFalse função pelo seguinte código, que testa vários valores inferiores a dois, o número primo mais baixo:

<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

Execute dotnet teste dois desses testes falharão. Para que todos os testes passem, altere a cláusula If no início do método IsPrime no ficheiro PrimeService.vb:

If candidate < 2 Then

Continue a iterar, adicionando mais testes e mais código na biblioteca principal.

Você criou uma pequena biblioteca e um conjunto de testes unitários para essa biblioteca. Você estruturou a solução para que a adição de novos pacotes e testes faça parte do fluxo de trabalho normal. Você concentrou a maior parte do seu tempo e esforço na resolução dos objetivos do aplicativo.

Ver também