Testing unità di librerie F# usando il test dotnet e NUnit

  • Articolo

In questa esercitazione viene illustrata un'esperienza interattiva di compilazione passo passo di una soluzione di esempio finalizzata all'apprendimento dei concetti base del testing unità. Se si preferisce seguire l'esercitazione usando una soluzione preesistente, visualizzare o scaricare il codice di esempio prima di iniziare. Per istruzioni sul download, vedere Esempi ed esercitazioni.

Questo articolo è relativo al test di un progetto .NET Core. Se si sta testando un progetto ASP.NET Core, vedere Test di integrazione in ASP.NET Core.

Prerequisiti

  • .NET 8 SDK o versioni successive.
  • Un editor di testo o editor di codice di propria scelta.

Creare il progetto di origine

Aprire una finestra della shell. Creare una directory denominata unit-testing-with-fsharp in cui archiviare la soluzione. In questa nuova directory eseguire il comando seguente per creare un nuovo file di soluzione per la libreria di classi e il progetto di test:

dotnet new sln

Creare quindi una directory MathService. Finora è stata creata la struttura di directory e file seguente:

/unit-testing-with-fsharp
    unit-testing-with-fsharp.sln
    /MathService

Impostare MathService come directory corrente ed eseguire il comando seguente per creare il progetto di origine:

dotnet new classlib -lang "F#"

Si crea un'implementazione non corretta del servizio matematico:

module MyMath =
    let squaresOfOdds xs = raise (System.NotImplementedException("You haven't written a test yet!"))

Tornare alla directory unit-test-con-fsharp. Eseguire il comando seguente per aggiungere il progetto di libreria di classi alla soluzione:

dotnet sln add .\MathService\MathService.fsproj

Creare il progetto di test

Creare quindi la directory MathService.Tests. Di seguito è illustrata la struttura di directory:

/unit-testing-with-fsharp
    unit-testing-with-fsharp.sln
    /MathService
        Source Files
        MathService.fsproj
    /MathService.Tests

Impostare MathService.Tests come directory corrente e creare un nuovo progetto usando il comando seguente:

dotnet new nunit -lang "F#"

Questo comando crea un progetto di test che usa NUnit come framework di test. Il modello generato configura il Test Runner nel file MathServiceTests.fsproj:

<ItemGroup>
  <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
  <PackageReference Include="NUnit" Version="4.1.0" />
  <PackageReference Include="NUnit3TestAdapter" Version="4.5.0" />
</ItemGroup>

Per creare ed eseguire unit test, il progetto di test richiede altri pacchetti. dotnet new nel passaggio precedente aggiunge NUnit e l'adattatore di test NUnit. Aggiungere ora la libreria di classi MathService come un'altra dipendenza del progetto. Usare il comando dotnet add reference:

dotnet add reference ../MathService/MathService.fsproj

È possibile visualizzare l'intero file nel repository degli esempi su GitHub.

Il layout della soluzione finale è il seguente:

/unit-testing-with-fsharp
    unit-testing-with-fsharp.sln
    /MathService
        Source Files
        MathService.fsproj
    /MathService.Tests
        Test Source Files
        MathService.Tests.fsproj

Eseguire il comando seguente nella directory unit-testing-with-fsharp:

dotnet sln add .\MathService.Tests\MathService.Tests.fsproj

Creare il primo test

Scrivere un test che genera errore, fare in modo che venga superato e quindi ripetere il processo. Aprire UnitTest1.fs e aggiungere il codice seguente:

namespace MathService.Tests

open System
open NUnit.Framework
open MathService

[<TestFixture>]
type TestClass () =

    [<Test>]
    member this.TestMethodPassing() =
        Assert.That(true, Is.True)

    [<Test>]
     member this.FailEveryTime() = Assert.That(false, Is.True)

L'attributo [<TestFixture>] indica una classe che contiene test. L'attributo [<Test>] indica un metodo di test eseguito dal Test Runner. Dalla directory unit-test-con-fsharp eseguire dotnet test per compilare i test e la libreria di classi, quindi eseguire i test. Il Test Runner di NUnit include il punto d'ingresso del programma per l'esecuzione dei test. dotnet test avvia il Test Runner usando il progetto di unit test creato.

Questi due test mostrano i test più semplici superati e non superati. My test viene superato e Fail every time non viene superato. A questo punto, creare un test per il metodo squaresOfOdds. Il metodo squaresOfOdds restituisce una sequenza di quadrati di tutti i valori interi dispari che fanno parte della sequenza di input. Anziché tentare di scrivere tutte queste funzioni in una sola volta, è possibile creare in modo iterativo test per la convalida della funzionalità. Per fare in modo che ogni test venga superato è necessario creare le funzionalità necessarie per il metodo.

Il test più semplice che si può scrivere consiste nel chiamare squaresOfOdds con tutti i numeri pari. In questo caso il risultato dovrebbe essere una sequenza vuota di numeri interi. Ecco questo test:

[<Test>]
member this.TestEvenSequence() =
    let expected = Seq.empty<int>
    let actual = MyMath.squaresOfOdds [2; 4; 6; 8; 10]
    Assert.That(actual, Is.EqualTo(expected))

Si noti che la sequenza di expected viene convertita in un elenco. Il framework NUnit si basa su molti tipi .NET standard. Questa dipendenza indica che l'interfaccia pubblica e i risultati previsti supportano ICollection invece di IEnumerable.

Quando si esegue il test, si noterà che non viene superato. Questo perché non è ancora stata creata l'implementazione. Fare in modo che questo test venga superato scrivendo il codice più semplice nella classe Library.fs nel progetto MathService funzionante:

let squaresOfOdds xs =
    Seq.empty<int>

Nella directory unit-test-con-fsharp eseguire di nuovo dotnet test. Il comando dotnet test esegue prima una compilazione del progetto MathService e quindi del progetto MathService.Tests. Dopo la compilazione di entrambi i progetti, verranno eseguiti i test. Due test vengono ora superati.

Completare i requisiti

Ora che il test è stato superato, è necessario scriverne altri. Il prossimo test case semplice opera su una sequenza in cui l'unico numero dispari è 1. Il numero 1 è più semplice perché il quadrato di 1 è 1. Ecco questo test:

[<Test>]
member public this.TestOnesAndEvens() =
    let expected = [1; 1; 1; 1]
    let actual = MyMath.squaresOfOdds [2; 1; 4; 1; 6; 1; 8; 1; 10]
    Assert.That(actual, Is.EqualTo(expected))

Il nuovo test non viene superato con l'esecuzione di dotnet test. È necessario aggiornare il metodo squaresOfOdds per gestire il nuovo test. È necessario filtrare tutti i numeri pari fuori sequenza per fare in modo che il test venga superato. È possibile farlo scrivendo una breve funzione di filtro e usando Seq.filter:

let private isOdd x = x % 2 <> 0

let squaresOfOdds xs =
    xs
    |> Seq.filter isOdd

Manca un altro passaggio: elevare al quadrato ciascuno dei numeri di dispari. Per iniziare, scrivere un nuovo test:

[<Test>]
member public this.TestSquaresOfOdds() =
    let expected = [1; 9; 25; 49; 81]
    let actual = MyMath.squaresOfOdds [1; 2; 3; 4; 5; 6; 7; 8; 9; 10]
    Assert.That(actual, Is.EqualTo(expected))

È possibile correggere il test tramite il piping della sequenza filtrata attraverso un'operazione di mapping per calcolare il quadrato di ogni numero dispari:

let private square x = x * x
let private isOdd x = x % 2 <> 0

let squaresOfOdds xs =
    xs
    |> Seq.filter isOdd
    |> Seq.map square

È stata compilata una piccola libreria e un set di unit test per tale libreria. La soluzione è stata strutturata in modo che l'aggiunta di nuovi pacchetti e test faccia parte del normale flusso di lavoro. La maggior parte del tempo e dell'impegno è dedicata alla soluzione degli obiettivi dell'applicazione.

Vedi anche