XUnit日志扩展库中文介绍

【实例简介】
XUnit日志扩展
这是一个为XUnit测试提供日志输出功能的扩展库，允许开发者将测试日志直接输出到测试结果中，提高了日志查看的便利性。

简介
MartinCostello.Logging.XUnit 是一个扩展库，它通过ILogger基础设施，将你的xunit测试日志输出到测试结果中。

该库主要针对Microsoft的ILoggerFactory日志实现。如果你使用的是其他日志实现，比如Serilog，可以考虑使用类似Serilog.Sinks.XUnit的包。

安装
通过.NET SDK从NuGet安装库：

dotnet add package MartinCostello.Logging.XUnit

使用方法
以下是一个使用这个库的示例代码：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Xunit;
using Xunit.Abstractions;

namespace MyApp.Calculator;

public class CalculatorTests(ITestOutputHelper outputHelper)
{
    [Fact]
    public void Calculator_Sums_Two_Integers()
    {
        using var serviceProvider = new ServiceCollection()
            .AddLogging((builder) => builder.AddXUnit(outputHelper))
            .AddSingleton<Calculator>()
            .BuildServiceProvider();

        var calculator = services.GetRequiredService<Calculator>();

        int actual = calculator.Sum(1, 2);

        Assert.AreEqual(3, actual);
    }
}

public sealed class Calculator(ILogger<Calculator> logger)
{
    public int Sum(int x, int y)
    {
        int sum = x + y;

        logger.LogInformation("The sum of {x} and {y} is {sum}.", x, y, sum);

        return sum;
    }
}

这个扩展库不仅支持单元测试，还支持ASP.NET Core HTTP应用的集成测试。

反馈
对于任何反馈或问题，可以通过项目的GitHub页面提交。
授权协议
该项目采用Apache 2.0授权协议。
构建与测试
自行编译库需要安装Git和.NET SDK（版本8.0.100或更高）。
【实例截图】
【核心代码】
文件清单
└── xunit-logging-0762802f0d1a167c85488e643687a6674d0cf88f
    ├── build.ps1
    ├── CODE_OF_CONDUCT.md
    ├── Directory.Build.props
    ├── Directory.Build.targets
    ├── Directory.Packages.props
    ├── global.json
    ├── LICENSE
    ├── Logging.XUnit.ruleset
    ├── Logging.XUnit.sln
    ├── Logging.XUnit.snk
    ├── NuGet.config
    ├── README.md
    ├── SECURITY.md
    ├── src
    │   └── Logging.XUnit
    │       ├── AmbientTestOutputHelperAccessor.cs
    │       ├── IMessageSinkAccessor.cs
    │       ├── IMessageSinkExtensions.cs
    │       ├── ITestOutputHelperAccessor.cs
    │       ├── ITestOutputHelperExtensions.cs
    │       ├── MartinCostello.Logging.XUnit.csproj
    │       ├── MessageSinkAccessor.cs
    │       ├── StringSyntaxAttribute.cs
    │       ├── TestOutputHelperAccessor.cs
    │       ├── XUnitLogger.cs
    │       ├── XUnitLoggerExtensions.IMessageSink.cs
    │       ├── XUnitLoggerExtensions.ITestOutputHelper.cs
    │       ├── XUnitLogger.IMessageSink.cs
    │       ├── XUnitLogger.ITestOutputHelper.cs
    │       ├── XUnitLoggerOptions.cs
    │       ├── XUnitLoggerProvider.cs
    │       ├── XUnitLoggerProvider.IMessageSink.cs
    │       ├── XUnitLoggerProvider.ITestOutputHelper.cs
    │       └── XUnitLogScope.cs
    ├── stylecop.json
    └── tests
        ├── Logging.XUnit.Tests
        │   ├── Constructor.cs
        │   ├── Examples.cs
        │   ├── Integration
        │   │   ├── DatabaseFixture.cs
        │   │   ├── DatabaseTests.cs
        │   │   ├── HttpApplicationTests.cs
        │   │   ├── HttpServerCollection.cs
        │   │   ├── HttpServerFixture.cs
        │   │   └── PrintableDiagnosticMessage.cs
        │   ├── IntegrationTests.cs
        │   ├── MartinCostello.Logging.XUnit.Tests.csproj
        │   ├── XUnitLoggerExtensionsTests.cs
        │   ├── XUnitLoggerProviderTests.cs
        │   ├── XUnitLoggerTests.cs
        │   └── xunit.runner.json
        └── SampleApp
            ├── appsettings.Development.json
            ├── appsettings.json
            ├── Program.cs
            ├── Properties
            │   └── launchSettings.json
            └── SampleApp.csproj

8 directories, 52 files