Поделиться через

Модульное тестирование библиотек F# в .NET Core с использованием dotnet test и MSTest.

В этом руководстве вы познакомитесь с интерактивным процессом пошагового создания примерного решения, чтобы изучить концепции модульного тестирования. Если вы предпочитаете следовать руководству с помощью предварительно созданного решения, просмотрите или скачайте пример кода перед началом. Инструкции по скачиванию смотрите в разделах Образцы и руководства.

В этой статье описывается тестирование проекта .NET Core. Если вы тестируете проект ASP.NET Core, см. тесты интеграции в ASP.NET Core.

Создание исходного проекта

Откройте окно оболочки. Создайте каталог с именем unit-testing-with-fsharp для хранения решения. В этом новом каталоге запустите dotnet new sln, чтобы создать новое решение. Это упрощает управление библиотекой классов и проектом модульного теста. В каталоге решения создайте каталог MathService. Структура каталога и файла до сих пор показана ниже:

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

Сделайте MathService текущим каталогом и запустите dotnet new classlib -lang "F#" для создания исходного проекта. Вы создадите некорректную реализацию математического сервиса.

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

Измените каталог обратно в каталог unit-testing-with-fsharp. Запустите dotnet sln add .\MathService\MathService.fsproj, чтобы добавить проект библиотеки классов в решение.

Создание тестового проекта

Затем создайте каталог MathService.Tests. В следующей схеме показана структура каталога:

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

Сделайте каталог MathService.Tests текущим каталогом и создайте новый проект с помощью dotnet new mstest -lang "F#". При этом создается тестовый проект, использующий MSTest в качестве платформы тестирования. Созданный шаблон настраивает средство выполнения теста в 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>

Тестовый проект требует создания и запуска модульных тестов других пакетов. dotnet new на предыдущем шаге добавлен MSTest. Теперь добавьте библиотеку классов MathService в качестве другой зависимости в проект. Используйте команду dotnet reference add:

dotnet reference add ../MathService/MathService.fsproj

Весь файл можно увидеть в репозитории примеров на сайте GitHub.

У вас есть следующий окончательный макет решения:

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

Выполните dotnet sln add .\MathService.Tests\MathService.Tests.fsproj в каталоге unit-testing-with-fsharp.

Создание первого теста

Вы пишете один тест, который не проходит, сделайте так, чтобы он прошёл, а затем повторите процесс. Откройте Test.fs и добавьте следующий код:

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)

Атрибут [<TestClass>] обозначает класс, содержащий тесты. Атрибут [<TestMethod>] обозначает метод тестирования, выполняемый тестовым запускателем. В каталоге unit-testing-with-fsharp выполните dotnet test, чтобы создать тесты и библиотеку классов, а затем запустить тесты. Средство выполнения тестов MSTest содержит точку входа, используемую для их запуска. dotnet test запускает тестовый раннер с использованием созданного вами проекта модульного тестирования.

Эти два теста демонстрируют наиболее простые примеры успешных и неудачных тестов. My test успешно проходит и Fail every time завершается ошибкой. Теперь создайте тест для метода squaresOfOdds. Метод squaresOfOdds возвращает список квадратов всех нечетных целых значений, которые являются частью входной последовательности. Вместо того чтобы одновременно записывать все эти функции, можно итеративно создавать тесты, проверяющие функциональные возможности. Чтобы каждый тест проходил успешно, необходимо создать соответствующую функциональность метода.

Самый простой тест, который можно написать, заключается в вызове squaresOfOdds со всеми четными числами, где результат должен быть пустой последовательностью целых чисел. Вот этот тест:

[<TestMethod>]
member this.TestEvenSequence() =
    let expected = Seq.empty<int> |> Seq.toList
    let actual = MyMath.squaresOfOdds [2; 4; 6; 8; 10]
    Assert.AreEqual(expected, actual)

Обратите внимание, что последовательность expected преобразована в список. Библиотека MSTest использует множество стандартных типов .NET. Эта зависимость означает, что общедоступный интерфейс и ожидаемые результаты поддерживают ICollection, а не IEnumerable.

При запуске теста вы увидите, что тест завершается сбоем. Вы еще не создали реализацию. Выполните этот тест, написав самый простой код в классе Mathservice, который работает:

let squaresOfOdds xs =
    Seq.empty<int> |> Seq.toList

В каталоге unit-testing-with-fsharp выполните dotnet test еще раз. Команда dotnet test запускает сборку для проекта MathService, а затем для проекта MathService.Tests. После создания обоих проектов он запускает этот одиночный тест. Он проходит.

Выполнение требований

Теперь, когда вы сделали один тестовый проход, пришло время написать больше. Следующий простой случай работает с последовательностью, единственное нечетное число которой — 1. Число 1 проще, так как квадрат 1 равен 1. Вот следующий тест:

[<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 проваливает новый тест. Для обработки этого нового теста необходимо обновить метод squaresOfOdds. Чтобы пройти этот тест, необходимо отфильтровать все четные числа из последовательности. Это можно сделать, написав небольшую функцию фильтра и используя Seq.filter:

let private isOdd x = x % 2 <> 0

let squaresOfOdds xs =
    xs
    |> Seq.filter isOdd |> Seq.toList

Следует обратить внимание на вызов Seq.toList. Это создает список, реализующий интерфейс ICollection.

Есть еще один шаг: возвести в квадрат каждое из нечетных чисел. Начните с написания нового теста:

[<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)

Вы можете скорректировать тест, направив отфильтрованную последовательность с помощью операции отображения для вычисления квадрата каждого нечетного числа.

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

Вы создали небольшую библиотеку и набор модульных тестов для этой библиотеки. Вы структурировали решение таким образом, чтобы добавление новых пакетов и тестов было частью обычного рабочего процесса. Вы сосредоточили большую часть времени и усилий на решении целей приложения.

См. также