search

WangShuXian6 / blog

FE-BLOG
https://wangshuxian6.github.io/blog/
MIT License
46 stars 10 forks source link

NUnit #173

Open WangShuXian6 opened 1 year ago

WangShuXian6 commented 1 year ago

NUnit

NUnit.org https://github.com/nunit

NUnit 是所有 .Net 语言的单元测试框架。最初从 JUnit 移植，当前 生产版本版本 3 已完全重写，具有许多新功能并支持广泛的 .NET 平台。

WangShuXian6 commented 1 year ago

示例

,NET 8 / NUnit 3

创建一个新的类库项目 用以测试

dotnet new classlib -n MathLib
cd MathLib

编写你的类库代码**

MathLib\SimpleMath.cs


namespace MathLib;

public static class SimpleMath { public static int Add(int a, int b) { return a + b; } }


>`MathLib\MathLib.csproj` 系统生成
```csproj
<Project Sdk="Microsoft.NET.Sdk">

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

</Project>

生成一个 NUnit 测试项目示例

-o后接项目目录名称,示例为 MathLibTest

dotnet new nunit -o MathLibTest

来自 https://docs.nunit.org/articles/nunit/getting-started/installation.html

引用库项目

dotnet add reference ../MathLib/MathLib.csproj

编写测试

MathLibTest\SimpleMathTest.cs


using MathLib;
namespace MathLibTest;

public class SimpleMathTests { [SetUp] public void Setup() { }

[TestCase(1, 2, 3)]
public void AddTest(int a, int b, int expectedResult)
{
    int result = SimpleMath.Add(a, b);
    Assert.That(expectedResult, Is.EqualTo(result));
    Assert.Pass();
}

}


>`MathLibTest\GlobalUsings.cs` 系统生成
```cs
global using NUnit.Framework;

MathLibTest\MathLibTest.csproj 系统生成


<Project Sdk="Microsoft.NET.Sdk">
net8.0 enable enable false true 


## `TestC.sln`
>系统生成
```sln

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.5.002.0
MinimumVisualStudioVersion = 10.0.40219.1
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MathLib", "MathLib\MathLib.csproj", "{DC429321-8446-4DEB-A930-55A64C414066}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MathLibTest", "MathLibTest\MathLibTest.csproj", "{D9B52C00-E99D-4257-842D-83D88B7E16C1}"
EndProject
Global
    GlobalSection(SolutionConfigurationPlatforms) = preSolution
        Debug|Any CPU = Debug|Any CPU
        Release|Any CPU = Release|Any CPU
    EndGlobalSection
    GlobalSection(ProjectConfigurationPlatforms) = postSolution
        {DC429321-8446-4DEB-A930-55A64C414066}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
        {DC429321-8446-4DEB-A930-55A64C414066}.Debug|Any CPU.Build.0 = Debug|Any CPU
        {DC429321-8446-4DEB-A930-55A64C414066}.Release|Any CPU.ActiveCfg = Release|Any CPU
        {DC429321-8446-4DEB-A930-55A64C414066}.Release|Any CPU.Build.0 = Release|Any CPU
        {D9B52C00-E99D-4257-842D-83D88B7E16C1}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
        {D9B52C00-E99D-4257-842D-83D88B7E16C1}.Debug|Any CPU.Build.0 = Debug|Any CPU
        {D9B52C00-E99D-4257-842D-83D88B7E16C1}.Release|Any CPU.ActiveCfg = Release|Any CPU
        {D9B52C00-E99D-4257-842D-83D88B7E16C1}.Release|Any CPU.Build.0 = Release|Any CPU
    EndGlobalSection
    GlobalSection(SolutionProperties) = preSolution
        HideSolutionNode = FALSE
    EndGlobalSection
    GlobalSection(ExtensibilityGlobals) = postSolution
        SolutionGuid = {238F8662-73C3-4E72-97F8-438814AB1096}
    EndGlobalSection
EndGlobal

运行测试

dotnet test
D:\project\C#\TestC\MathLibTest\bin\Debug\net8.0\MathLibTest.dll (.NETCoreApp,Version=v8.0)的测试运行
Microsoft (R) 测试执行命令行工具版本 17.8.0-preview-23421-06 (x64)
版权所有 (C) Microsoft Corporation。保留所有权利。

正在启动测试执行，请稍候...
总共 1 个测试文件与指定模式相匹配。

已通过! - 失败:     0，通过:     1，已跳过:     0，总计:     1，持续时间: 21 ms - MathLibTest.dll (net8.0)

dotnet test 默认会运行所有发现的测试。以下是其背后的基本原理：

  1. 测试发现：当你运行 dotnet test 命令时，它首先会使用测试适配器（例如 xUnit, NUnit, MSTest 的适配器）来发现项目中的所有测试。这些适配器知道如何识别和定位各自框架的测试方法。
  2. 编译项目：在运行测试之前，dotnet test 会编译整个解决方案或测试项目，以确保所有的代码都是最新的。
  3. 运行测试：编译完成后，dotnet test 使用相应的测试运行器执行已发现的测试。
  4. 收集和报告：测试运行时，结果会被收集起来。一旦所有测试都运行完成，dotnet test 会在控制台输出一个测试结果的概览，包括成功、失败和跳过的测试数量。
  5. 附加功能：dotnet test 还支持其他参数，例如并行测试、过滤特定的测试、生成详细的日志等。

    其核心原理在于测试框架的适配器和运行器。适配器负责识别测试，而运行器则执行这些测试。这是一个抽象的流程，使得 .NET Core SDK 能够与多种测试框架（如 xUnit, NUnit, MSTest）兼容。