ApplicationHostFactory Class

Definition

Namespace

Codebelt.Extensions.Xunit.Hosting

Assemblies

Codebelt.Extensions.Xunit.Hosting.dll

Source

src/Codebelt.Extensions.Xunit.Hosting/ApplicationHostFactory.cs

Provides factory methods for creating application hosts from an entry point assembly.

public static class ApplicationHostFactory

Inheritance

object

ApplicationHostFactory

Examples

The test project references a worker application's entry-point assembly. ApplicationHostFactory.Create<TEntryPoint> preserves the compatibility path, including direct use of an application's CreateHostBuilder when it is available. ApplicationTestFactory.Create<TEntryPoint> uses ManagedApplicationFixture<TEntryPoint> by default when the application entry point should own startup; pass an explicit fixture when a shared test context needs to customize its lifecycle. Because this lower-level factory returns the host directly, the caller still owns disposal.

using Codebelt.Extensions.Xunit.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace WorkerApp.Tests;

public sealed class ApplicationHostFactoryExample
{
    public string GetTestIdentity()
    {
        using IHost host = ApplicationHostFactory.Create<WorkerProgram>(builder =>
        {
            builder.ConfigureServices(services =>
                services.AddSingleton(new WorkerIdentity("Test inventory worker")));
        });

        var identity = host.Services.GetRequiredService<WorkerIdentity>();
        return identity.Name;
    }
}

public sealed record WorkerIdentity(string Name);

public sealed class WorkerProgram
{
    public static IHostBuilder CreateHostBuilder(string[] args)
    {
        return Host.CreateDefaultBuilder(args);
    }

    public static void Main(string[] args)
    {
        using var host = CreateHostBuilder(args).Build();
        host.Run();
    }
}

Methods

Name	Description
Create<TEntryPoint>(Action<IHostBuilder>)	Creates, configures and builds an IHost from the assembly containing TEntryPoint.
Create<TEntryPoint>(Action<IHostBuilder>, bool)	Creates, configures and builds an IHost from the assembly containing TEntryPoint.