Serilog.Sinks.XUnit.Injectable 4.0.96

dotnet add package Serilog.Sinks.XUnit.Injectable --version 4.0.96
                    
NuGet\Install-Package Serilog.Sinks.XUnit.Injectable -Version 4.0.96
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Serilog.Sinks.XUnit.Injectable" Version="4.0.96" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Serilog.Sinks.XUnit.Injectable" Version="4.0.96" />
                    
Directory.Packages.props
<PackageReference Include="Serilog.Sinks.XUnit.Injectable" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Serilog.Sinks.XUnit.Injectable --version 4.0.96
                    
#r "nuget: Serilog.Sinks.XUnit.Injectable, 4.0.96"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=Serilog.Sinks.XUnit.Injectable&version=4.0.96
                    
Install Serilog.Sinks.XUnit.Injectable as a Cake Addin
#tool nuget:?package=Serilog.Sinks.XUnit.Injectable&version=4.0.96
                    
Install Serilog.Sinks.XUnit.Injectable as a Cake Tool

alternate text is missing from this package README image alternate text is missing from this package README image alternate text is missing from this package README image

Serilog.Sinks.XUnit.Injectable

The injectable, Serilog xUnit test output sink

Leverage xUnit's TestOutputHelper across tests that share state

Common use cases

  • Integration tests (i.e. WebApplicationFactory)
  • Unit tests that utilize Dependency Injection in a fixture

Why?

When running a suite of tests, it can be expensive to build a new DI ServiceProvider, and even more so, a WebApplicationFactory. Hence, these can be stored in a xUnit fixture and reused across tests.

xUnit provides a new TestOutputHelper per test, and so even if you register it as a sink initially, the next test will not capture/output messages from the services inside the provider.

This library addresses that issue by allowing for the TestOutputHelper from each test to be "injected" into the fixture as it's running. It also maintains the context of each test in the appropriate test runner window.

Examples are provided for both Unit and Integration tests. For brevity, the actual injection is shown in the constructor of the test class in the examples below, but you'll probably want to leverage a base class.

xUnit Compatibility

  • Version 3.x: Supports xUnit 2.9.
  • Latest Version: Fully supports xUnit 3.

Installation

dotnet add package Serilog.Sinks.XUnit.Injectable

Example: WebApplicationFactory "integration tests"


public class ApiFixture : IAsyncLifetime
{
    public WebApplicationFactory<Program> ApiFactory { get; set; } = default!;

    public Task InitializeAsync()
    {
        ApiFactory = new WebApplicationFactory<Program>();
        ApiFactory = ApiFactory.WithWebHostBuilder(builder =>
        {
            // Instantiate the sink, with any configuration (like outputTemplate, formatProvider)
            var injectableTestOutputSink = new InjectableTestOutputSink();

            builder.ConfigureServices(services =>
            {
                // Register the sink as a singleton
                services.AddSingleton<IInjectableTestOutputSink>(injectableTestOutputSink); 
            });

            builder.UseSerilog((_, loggerConfiguration) =>
            {
                // Add the sink to the logger configuration
                loggerConfiguration.WriteTo.InjectableTestOutput(injectableTestOutputSink);
            });
        });

        return Task.CompletedTask;
    }

    public async Task DisposeAsync()
    {
        await ApiFactory.DisposeAsync();
    }
}
[Collection("ApiCollection")]
public class ApiTests
{
    private readonly HttpClient _client;

    public ApiTests(ApiFixture fixture, ITestOutputHelper testOutputHelper)
    {
        var outputSink = (IInjectableTestOutputSink)fixture.ApiFactory.Services.GetService(typeof(IInjectableTestOutputSink))!;
        outputSink.Inject(testOutputHelper); // <-- inject the new ITestOutputHelper into the sink

        _client = fixture.ApiFactory.CreateClient();
    }

    [Fact]
    public async Task Get_should_have_log_messages_and_be_successful()
    {
        HttpResponseMessage response = await _client.GetAsync("/");
        response.EnsureSuccessStatusCode();
    }
}

Example: ServiceProvider "Fixtured unit tests"


public class UnitFixture : IAsyncLifetime
{
    public ServiceProvider ServiceProvider { get; set; } = default!;

    protected IServiceCollection Services { get; set; }

    public UnitFixture()
    {
        var injectableTestOutputSink = new InjectableTestOutputSink();

        Services = new ServiceCollection();

        Services.AddSingleton<IInjectableTestOutputSink>(injectableTestOutputSink);
        Services.AddSingleton<SampleUtil>();

        ILogger serilogLogger = new LoggerConfiguration()
            .WriteTo.InjectableTestOutput(injectableTestOutputSink)
            .CreateLogger();

        Log.Logger = serilogLogger;

        Services.AddLogging(builder =>
        {
            builder.AddSerilog(dispose: true);
        });
    }

    public virtual Task InitializeAsync()
    {
        ServiceProvider = Services.BuildServiceProvider();

        return Task.CompletedTask;
    }

    public virtual async Task DisposeAsync()
    {
        await ServiceProvider.DisposeAsync();
    }
}

[Collection("UnitCollection")]
public class SampleUtilTests
{
    private readonly SampleUtil _util;

    public SampleUtilTests(UnitFixture fixture, ITestOutputHelper testOutputHelper)
    {
        var outputSink = (IInjectableTestOutputSink)fixture.ServiceProvider.GetService(typeof(IInjectableTestOutputSink));
        outputSink.Inject(testOutputHelper);

        _util = (SampleUtil)fixture.ServiceProvider.GetService(typeof(SampleUtil));
    }

    [Fact]
    public void DoWork_should_result_with_log_messages()
    {
        _util.DoWork();
    }
}

SampleUtil


public class SampleUtil
{
    private readonly ILogger<SampleUtil> _logger;

    public SampleUtil(ILogger<SampleUtil> logger)
    {
        _logger = logger;
    }

    public void DoWork()
    {
        Log.Logger.Information("----- Did some work (Serilog logger) -----");
        _logger.LogInformation("----- Did some work (Microsoft logger) -----");
    }
}
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Serilog.Sinks.XUnit.Injectable:

Package Downloads
Soenneker.Tests.Unit

A base test providing faker and autofaker capabilities

Soenneker.Fixtures.Unit

A base xUnit fixture providing injectable log output, DI mechanisms like IServiceCollection and ServiceProvider, and AutoFaker/Faker for generating test data.

DotCart.Drivers.Serilog

Package Description

Soenneker.Fixtures.Integration

Provides a reusable and generic integration test xunit fixture that dynamically registers and configures WebApplicationFactory instances for multiple ASP.NET Core projects with support for custom app settings, authentication, logging, and test utilities.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.0.96 4,975 4/8/2025
4.0.95 39,458 4/5/2025
4.0.94 149 4/5/2025
4.0.93 74,254 3/11/2025
4.0.92 24,753 3/1/2025
4.0.91 3,777 3/1/2025
4.0.90 57,680 2/11/2025
4.0.89 11,378 2/10/2025
4.0.88 13,822 2/7/2025
4.0.87 3,283 2/7/2025
4.0.86 3,188 2/7/2025
4.0.84 92,987 1/20/2025
4.0.83 37,738 1/14/2025
4.0.82 18,001 1/10/2025
4.0.81 1,329 1/10/2025
4.0.80 243 1/10/2025
4.0.79 15,371 1/2/2025
4.0.77 10,855 12/31/2024
4.0.76 10,814 12/31/2024
4.0.75 268 12/31/2024
4.0.74 256 12/31/2024
4.0.73 10,036 12/27/2024
4.0.72 8,033 12/24/2024
4.0.71 36,026 12/19/2024
4.0.68 4,985 12/18/2024
4.0.67 5,415 12/16/2024
4.0.66 267 12/16/2024
3.0.64 8,948 12/16/2024
3.0.63 14,253 12/9/2024
3.0.62 10,967 12/6/2024
3.0.61 9,302 12/5/2024
3.0.60 23,245 12/3/2024
3.0.59 268 12/3/2024
3.0.58 34,657 11/19/2024
3.0.57 17,137 11/14/2024
3.0.56 224 11/14/2024
2.1.55 4,027 11/13/2024
2.1.54 7,005 11/12/2024
2.1.53 201 11/12/2024
2.1.52 37,980 10/22/2024
2.1.51 14,890 10/11/2024
2.1.50 8,461 10/8/2024
2.1.49 755 10/8/2024
2.1.48 23,591 9/28/2024
2.1.47 7,168 9/27/2024
2.1.46 22,147 9/23/2024
2.1.45 44,910 9/6/2024
2.1.44 31,776 8/20/2024
2.1.43 12,738 8/13/2024
2.1.42 15,572 8/1/2024
2.1.41 5,424 7/25/2024
2.1.40 34,516 7/9/2024
2.1.39 4,601 7/9/2024
2.1.38 192 7/9/2024
2.1.37 182 7/9/2024
2.1.36 44,484 6/1/2024
2.1.35 1,015 6/1/2024
2.1.34 47,041 5/25/2024
2.1.33 209 5/25/2024
2.1.32 15,788 5/22/2024
2.1.31 12,822 5/14/2024
2.1.30 17,902 4/27/2024
2.1.29 146 4/27/2024
2.1.28 13,942 4/12/2024
2.1.27 2,766 4/11/2024
2.1.26 5,665 4/9/2024
2.1.25 21,165 3/13/2024
2.1.24 2,711 3/12/2024
2.1.23 35,822 2/21/2024
2.1.22 10,231 2/16/2024
2.1.21 143 2/16/2024
2.1.20 6,828 2/13/2024
2.1.19 20,469 2/6/2024
2.1.18 41,704 1/19/2024
2.1.17 7,791 1/15/2024
2.1.16 7,178 1/9/2024
2.1.15 5,320 1/5/2024
2.1.14 5,511 12/27/2023
2.1.13 801 12/27/2023
2.1.12 3,278 12/25/2023
2.1.11 2,626 12/24/2023
2.1.10 2,648 12/23/2023
2.1.9 147 12/23/2023
2.1.8 11,402 12/9/2023
2.1.7 128 12/9/2023
2.1.6 8,116 12/4/2023
2.1.5 7,491 11/23/2023
2.1.4 147 11/23/2023
2.1.3 2,740 11/23/2023
2.1.2 12,088 11/16/2023
2.0.52 7,550 11/15/2023
2.0.51 135 11/15/2023
2.0.50 342 11/15/2023
1.0.65 201 11/15/2023
1.0.64 7,323 11/13/2023
1.0.63 1,926 11/10/2023
1.0.62 341 11/9/2023
1.0.61 3,640 11/3/2023
1.0.60 3,031 11/1/2023
1.0.59 2,717 10/25/2023
1.0.58 2,984 10/17/2023
1.0.57 2,248 10/13/2023
1.0.56 192 10/13/2023
1.0.55 2,481 10/11/2023
1.0.54 4,762 9/18/2023
1.0.53 135 9/18/2023
1.0.52 3,029 9/13/2023
1.0.51 3,586 8/30/2023
1.0.50 6,812 8/17/2023
1.0.49 3,184 8/9/2023
1.0.48 2,943 8/7/2023
1.0.47 4,461 7/12/2023
1.0.46 2,215 7/7/2023
1.0.45 173 7/7/2023
1.0.44 4,155 6/28/2023
1.0.43 3,009 6/23/2023
1.0.42 1,009 6/22/2023
1.0.41 1,497 6/20/2023
1.0.40 1,975 6/14/2023
1.0.39 3,254 6/7/2023
1.0.38 3,413 6/2/2023
1.0.37 7,796 5/24/2023
1.0.36 713 5/23/2023
1.0.35 1,507 5/23/2023
1.0.34 852 5/23/2023
1.0.33 158 5/23/2023
1.0.32 479 5/22/2023
1.0.31 1,868 5/17/2023
1.0.30 1,359 5/11/2023
1.0.29 1,259 4/21/2023
1.0.28 1,979 4/12/2023
1.0.27 1,104 4/3/2023
1.0.26 1,304 3/23/2023
1.0.16 8,777 3/9/2023
1.0.15 709 2/23/2023
1.0.10 1,936 1/19/2023
1.0.9 360 1/16/2023
1.0.6 3,654 6/5/2022
1.0.5 428 6/4/2022
1.0.4 417 6/4/2022
1.0.3 424 6/4/2022
1.0.0 508 1/16/2023