Compartir a través de

Bibliotecas de .NET Core de prueba unitaria de Visual Basic con pruebas de dotnet y MSTest

  • Artículo

Este tutorial le guía por una experiencia interactiva de creación de una solución de ejemplo paso a paso para aprender los conceptos de pruebas unitarias. Si prefiere seguir el tutorial con una solución precompilada, vea o descargue el código de ejemplo antes de comenzar. Para obtener instrucciones de descarga, vea Ejemplos y tutoriales.

Este artículo trata sobre la prueba de un proyecto de .NET Core. Si está realizando pruebas con un proyecto de ASP.NET Core, consulte Pruebas de integración en ASP.NET Core.

Crear el proyecto de origen

Abra una ventana del Shell. Cree un directorio llamado unit-testing-vb-mstest que contenga la solución. En este directorio nuevo, ejecute dotnet new sln para crear una solución nueva. Esta práctica permite facilitar la administración de la biblioteca de clases y del proyecto de prueba unitaria. En el directorio de la solución, cree un directorio PrimeService. Hasta el momento, esta es la estructura de directorios y archivos:

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

Convierta PrimeService en el directorio actual y ejecute dotnet new classlib -lang VB para crear el proyecto de origen. Cambie el nombre de Class1.VB a PrimeService.VB. Creará una implementación de errores de la clase 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

Cambien nuevamente el directorio al directorio unit-testing-vb-using-mstest. Ejecute dotnet sln add .\PrimeService\PrimeService.vbproj para agregar el proyecto de biblioteca de clases a la solución.

Crear el proyecto de prueba

A continuación, cree el directorio PrimeService.Tests. En el esquema siguiente se muestra la estructura de directorios:

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

Convierta el directorio PrimeService.Tests en el directorio actual y cree un proyecto nuevo con dotnet new mstest -lang VB. Este comando crea un proyecto de prueba que usa MSTest como biblioteca de pruebas. La plantilla generada ha configurado el ejecutor de pruebas en 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>

El proyecto de prueba requiere otros paquetes para crear y ejecutar pruebas unitarias. dotnet new en el paso anterior agregó MSTest y el ejecutor de MSTest. Ahora, agregue la biblioteca de clases PrimeService como otra dependencia al proyecto. Use el comando dotnet add reference:

dotnet add reference ../PrimeService/PrimeService.vbproj

Puede ver todo el archivo en el repositorio de muestras en GitHub.

Tiene el diseño de solución final siguiente:

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

Ejecute dotnet sln add .\PrimeService.Tests\PrimeService.Tests.vbproj en el directorio unit-testing-vb-mstest.

Crear la primera prueba

Escribirá una prueba de errores, la aprobará y, luego, repetirá el proceso. Quite UnitTest1.vb del directorio PrimeService.Tests y cree un archivo de Visual Basic nuevo denominado PrimeService_IsPrimeShould.VB. Agregue el siguiente código:

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

El atributo <TestClass> indica una clase que contiene pruebas. El atributo <TestMethod> indica un método que el ejecutor de pruebas ejecuta. En unit-testing-vb-mstest, ejecute dotnet test para compilar las pruebas y la biblioteca de clases y luego ejecutar las pruebas. El ejecutor de pruebas de MSTest tiene el punto de entrada del programa para ejecutar las pruebas desde la consola. dotnet test inicia el ejecutor de pruebas con el proyecto de prueba unitaria que creó.

La prueba produce un error. Todavía no ha creado la implementación. Cree esta prueba que se supera escribiendo el código más simple en la clase 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

En el directorio unit-testing-vb-mstest, vuelva a ejecutar dotnet test. El comando dotnet test ejecuta una compilación del proyecto PrimeService y luego del proyecto PrimeService.Tests. Después de compilar ambos proyectos, se ejecuta esta única prueba. Pasa.

Agregar más características

Ahora que la prueba se ha superado, es el momento de escribir más. Hay algunos otros casos simples para números primos: 0, -1. Puede agregar esos casos como nuevas pruebas con el atributo <TestMethod>, pero enseguida este proceso se hace tedioso. Hay otros atributos de MSTest que le permiten escribir un conjunto de pruebas similares. Un atributo <DataTestMethod> representa un conjunto de pruebas que ejecutan el mismo código, pero tienen diferentes argumentos de entrada. Puede usar el atributo <DataRow> para especificar valores para esas entradas.

En lugar de crear pruebas nuevas, aplique estos dos atributos para crear una sola teoría. La teoría es un método que prueba varios valores menores que dos, que es el número primo menor:

<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

Ejecute dotnet test, y dos de estas pruebas no se superarán. Para superar todas las pruebas, cambie la cláusula if al principio del método:

if candidate < 2

Puede continuar recorriendo en iteración agregando más pruebas, más teorías y más código en la biblioteca principal. Ya tiene la versión terminada de las pruebas y la implementación completa de la biblioteca.

Ha creado una biblioteca pequeña y un conjunto de pruebas unitarias para esa biblioteca. Ha estructurado la solución, por lo que agregar pruebas y paquetes nuevos es parte del flujo de trabajo normal. Ha centrado la mayor parte del tiempo y del esfuerzo en resolver los objetivos de la aplicación.