Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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
/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.