Omówienie modułu uruchamiającego NUnit

Artykuł
05/24/2024

Moduł uruchamiający NUnit to uproszczona i przenośna alternatywa dla programu VSTest do uruchamiania testów we wszystkich kontekstach (na przykład potoków ciągłej integracji, interfejsu wiersza polecenia, Eksploratora testów programu Visual Studio i Eksploratora tekstu programu VS Code). Moduł uruchamiający NUnit jest osadzony bezpośrednio w projektach testowych NUnit i nie ma żadnych innych zależności aplikacji, takich jak vstest.console lub dotnet test, wymaganych do uruchomienia testów.

Moduł uruchamiający NUnit jest oprogramowaniem open source i opiera się na Microsoft.Testing.Platform bibliotece. Kod można znaleźć Microsoft.Testing.Platform w repozytorium Microsoft/testfx w witrynie GitHub. Moduł uruchamiający NUnit jest dostarczany z pakietem NUnit 5.0.0-beta.2 lub nowszym.

Włączanie modułu uruchamiającego NUnit w projekcie NUnit

Moduł uruchamiający NUnit można włączyć, dodając EnableNUnitRunner właściwość i ustawienie OutputType do Exe w pliku projektu. Należy również upewnić się, że używasz NUnit 5.0.0-beta.2 lub nowszych.

Rozważmy następujący przykładowy plik projektu:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <!-- Enable the NUnit runner, this is an opt-in feature -->
    <EnableNUnitRunner>true</EnableNUnitRunner>
    <OutputType>Exe</OutputType>

    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
    <PackageReference Include="NUnit" Version="4.1.0" />
    <PackageReference Include="NUnit.Analyzers" Version="4.2.0">
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
    <PackageReference Include="NUnit3TestAdapter" Version="5.0.0-beta.2" />

    <!--
      Coverlet collector isn't compatible with NUnit runner, you can
      either switch to Microsoft CodeCoverage (as shown below),
      or switch to be using coverlet global tool
      https://github.com/coverlet-coverage/coverlet#net-global-tool-guide-suffers-from-possible-known-issue
    -->
    <PackageReference Include="Microsoft.Testing.Extensions.CodeCoverage"
                      Version="17.10.1" />
  </ItemGroup>

</Project>

Konfiguracje i filtry

.runsettings

Moduł uruchamiający NUnit obsługuje ustawienia runsettings za pomocą opcji --settingswiersza polecenia . W poniższych poleceniach przedstawiono przykłady.

Za pomocą polecenia dotnet run:

dotnet run --project Contoso.MyTests -- --settings config.runsettings

Za pomocą polecenia dotnet exec:

dotnet exec Contoso.MyTests.dll --settings config.runsettings

— lub —

dotnet Contoso.MyTests.dll --settings config.runsettings

Przy użyciu pliku wykonywalnego:

Contoso.MyTests.exe --settings config.runsettings

Filtr testów

Filtr testów można zapewnić bezproblemowo przy użyciu opcji --filterwiersza polecenia . W poniższych poleceniach przedstawiono kilka przykładów.