F#-bibliotheken in .NET Core testen met behulp van dotnet-test en MSTest
In deze zelfstudie wordt u stapsgewijs begeleid bij het bouwen van een voorbeeldoplossing voor het leren van concepten voor het testen van eenheden. Als u liever de zelfstudie volgt met behulp van een vooraf gebouwde oplossing, bekijkt of downloadt u de voorbeeldcode voordat u begint. Zie Voorbeelden en zelfstudies voor downloadinstructies.
Dit artikel gaat over het testen van een .NET Core-project. Als u een ASP.NET Core-project test, raadpleegt u Integratietests in ASP.NET Core.
Het bronproject maken
Open een shellvenster. Maak een map met de naam unit-testing-with-fsharp om de oplossing te bewaren.
Voer in deze nieuwe map uit dotnet new sln om een nieuwe oplossing te maken. Hierdoor is het eenvoudiger om zowel de klassebibliotheek als het eenheidstestproject te beheren.
Maak in de oplossingsmap een MathService-map . De map en bestandsstructuur tot nu toe worden hieronder weergegeven:
/unit-testing-with-fsharp
unit-testing-with-fsharp.sln
/MathService
Maak MathService de huidige map en voer deze uit dotnet new classlib -lang "F#" om het bronproject te maken. U maakt een mislukte implementatie van de wiskundige service:
module MyMath =
let squaresOfOdds xs = raise (System.NotImplementedException("You haven't written a test yet!"))
Wijzig de map weer in de map unit-testing-with-fsharp . Voer uit dotnet sln add .\MathService\MathService.fsproj om het klassebibliotheekproject toe te voegen aan de oplossing.
Het testproject maken
Maak vervolgens de map MathService.Tests . In het volgende overzicht ziet u de mapstructuur:
/unit-testing-with-fsharp
unit-testing-with-fsharp.sln
/MathService
Source Files
MathService.fsproj
/MathService.Tests
Maak de map MathService.Tests de huidige map en maak een nieuw project met behulp van dotnet new mstest -lang "F#". Hiermee maakt u een testproject dat MSTest als testframework gebruikt. De gegenereerde sjabloon configureert de testrunner in de MathServiceTests.fsproj:
<ItemGroup>
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.3.0-preview-20170628-02" />
<PackageReference Include="MSTest.TestAdapter" Version="1.1.18" />
<PackageReference Include="MSTest.TestFramework" Version="1.1.18" />
</ItemGroup>
Voor het testproject zijn andere pakketten vereist om eenheidstests te maken en uit te voeren. dotnet new in de vorige stap zijn MSTest en de MSTest runner toegevoegd. Voeg nu de MathService klassebibliotheek toe als een andere afhankelijkheid aan het project. Gebruik de dotnet add reference opdracht:
dotnet add reference ../MathService/MathService.fsproj
U kunt het hele bestand zien in de opslagplaats met voorbeelden op GitHub.
U hebt de volgende indeling voor de uiteindelijke oplossing:
/unit-testing-with-fsharp
unit-testing-with-fsharp.sln
/MathService
Source Files
MathService.fsproj
/MathService.Tests
Test Source Files
MathServiceTests.fsproj
Voer deze uit dotnet sln add .\MathService.Tests\MathService.Tests.fsproj in de map unit-testing-with-fsharp .
De eerste test maken
U schrijft één mislukte test, laat deze slagen en herhaal het proces. Open Tests.fs en voeg de volgende code toe:
namespace MathService.Tests
open System
open Microsoft.VisualStudio.TestTools.UnitTesting
open MathService
[<TestClass>]
type TestClass () =
[<TestMethod>]
member this.TestMethodPassing() =
Assert.IsTrue(true)
[<TestMethod>]
member this.FailEveryTime() = Assert.IsTrue(false)
Het [<TestClass>] kenmerk geeft een klasse aan die tests bevat. Het [<TestMethod>] kenmerk geeft een testmethode aan die wordt uitgevoerd door de testloper. Voer vanuit de map dotnet test unit-testing-with-fsharp uit om de tests en de klassebibliotheek te bouwen en vervolgens de tests uit te voeren. De MSTest-testrunner bevat het programmainvoerpunt om uw tests uit te voeren. dotnet test start de testrunner met behulp van het eenheidstestproject dat u hebt gemaakt.
Deze twee tests tonen de meest eenvoudige geslaagde en mislukte tests. My test passeert en Fail every time mislukt. Maak nu een test voor de squaresOfOdds methode. De squaresOfOdds methode retourneert een lijst met de kwadraten van alle oneven gehele getallen die deel uitmaken van de invoerreeks. In plaats van al deze functies tegelijk te schrijven, kunt u iteratief tests maken waarmee de functionaliteit wordt gevalideerd. Het maken van elke testpas betekent het maken van de benodigde functionaliteit voor de methode.
De eenvoudigste test die we kunnen schrijven, is het aanroepen squaresOfOdds met alle even nummers, waarbij het resultaat een lege reeks gehele getallen moet zijn. Dit is de test:
[<TestMethod>]
member this.TestEvenSequence() =
let expected = Seq.empty<int> |> Seq.toList
let actual = MyMath.squaresOfOdds [2; 4; 6; 8; 10]
Assert.AreEqual(expected, actual)
U ziet dat de expected reeks is geconverteerd naar een lijst. De MSTest-bibliotheek is afhankelijk van veel standaard .NET-typen. Deze afhankelijkheid betekent dat uw openbare interface en verwachte resultaten ondersteuning bieden ICollection in plaats IEnumerablevan .
Wanneer u de test uitvoert, ziet u dat de test mislukt. U hebt de implementatie nog niet gemaakt. Zorg ervoor dat deze test wordt doorgegeven door de eenvoudigste code te schrijven in de Mathservice klasse die werkt:
let squaresOfOdds xs =
Seq.empty<int> |> Seq.toList
Voer dotnet test opnieuw uit in de map unit-testing-with-fsharp. Met de dotnet test opdracht wordt een build voor het MathService project uitgevoerd en vervolgens voor het MathService.Tests project. Na het bouwen van beide projecten wordt deze enkele test uitgevoerd. Het gaat voorbij.
De vereisten voltooien
Nu u één testpas hebt gemaakt, is het tijd om meer te schrijven. De volgende eenvoudige zaak werkt met een reeks waarvan alleen oneven getal is 1. Het getal 1 is gemakkelijker omdat het vierkant van 1 1 is. Dit is de volgende test:
[<TestMethod>]
member public this.TestOnesAndEvens() =
let expected = [1; 1; 1; 1]
let actual = MyMath.squaresOfOdds [2; 1; 4; 1; 6; 1; 8; 1; 10]
Assert.AreEqual(expected, actual)
dotnet test De nieuwe test kan niet worden uitgevoerd. U moet de squaresOfOdds methode bijwerken om deze nieuwe test af te handelen. U moet alle even getallen uit de reeks filteren om deze test te laten slagen. U kunt dit doen door een kleine filterfunctie te schrijven en het volgende te gebruiken Seq.filter:
let private isOdd x = x % 2 <> 0
let squaresOfOdds xs =
xs
|> Seq.filter isOdd |> Seq.toList
Let op de aanroep naar Seq.toList. Hiermee maakt u een lijst, waarmee de ICollection interface wordt geïmplementeerd.
Er is nog een stap: elk van de oneven getallen kwadrateren. Begin met het schrijven van een nieuwe test:
[<TestMethod>]
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.AreEqual(expected, actual)
U kunt de test oplossen door de gefilterde reeks door te spitsen via een kaartbewerking om het kwadraat van elk oneven getal te berekenen:
let private square x = x * x
let private isOdd x = x % 2 <> 0
let squaresOfOdds xs =
xs
|> Seq.filter isOdd
|> Seq.map square
|> Seq.toList
U hebt een kleine bibliotheek en een set eenheidstests voor die bibliotheek gemaakt. U hebt de oplossing gestructureerd zodat het toevoegen van nieuwe pakketten en tests deel uitmaakt van de normale werkstroom. U hebt zich het grootste deel van uw tijd en moeite geconcentreerd op het oplossen van de doelstellingen van de toepassing.
