TAF.Infra.TestKit.Integration 1.0.0

TAF.Infra.TestKit.Integration

Phase-2 integration-test foundation for the TAF platform. Separate package from TAF.Infra.TestKit so unit-test-only consumers aren't forced to pull in Testcontainers/Respawn/Microsoft.AspNetCore.Mvc.Testing.

What's here

• PostgresTestContainerFixture — starts a real, ephemeral postgres:16-alpine container via Testcontainers. Share one per test collection (ICollectionFixture<PostgresTestContainerFixture>), not per test class — container startup dominates otherwise.
• SqlScriptRunner — applies a hand-authored schema SQL script to the container once per collection. No service in this platform has a checked-in migration/DbUp story for its own schema (it's normally produced at runtime by taf_metadataservice's DDL engine against a real tenant database) — each pilot service's integration-test project ships its own minimal schema script covering just the tables its tests touch.
• RespawnHelper — truncates all tables back to empty between tests, without recreating the container or re-applying schema. Call ResetAsync() in a test's setup/teardown, not PostgresTestContainerFixture restart.
• ConfigurableWebApplicationFactory<TEntryPoint> — a WebApplicationFactory that layers a flat config-override dictionary over the service's real appsettings (e.g. pointing the DB connection at the Testcontainer, switching MessageBus:Provider to InMemory, disabling ServiceAuth for tests). The service's real Program.cs runs unmodified.

Usage shape (per pilot service)

[CollectionDefinition("Postgres")]
public class PostgresCollection : ICollectionFixture<PostgresTestContainerFixture> { }

[Collection("Postgres")]
public class MyIntegrationTests : IAsyncLifetime
{
    private readonly PostgresTestContainerFixture _postgres;
    private RespawnHelper _respawn = null!;
    private ConfigurableWebApplicationFactory<Program> _factory = null!;

    public MyIntegrationTests(PostgresTestContainerFixture postgres) => _postgres = postgres;

    public async Task InitializeAsync()
    {
        await SqlScriptRunner.ApplyFileAsync(_postgres.ConnectionString, "Schema/schema.sql");
        _respawn = await RespawnHelper.CreateAsync(_postgres.ConnectionString);
        _factory = new ConfigurableWebApplicationFactory<Program>(new Dictionary<string, string?>
        {
            ["ConnectionResolver:ResolverType"] = "Config",
            // ...service-specific overrides
        });
    }

    public async Task DisposeAsync()
    {
        await _respawn.ResetAsync();
        await _factory.DisposeAsync();
    }
}

Note that a real service's Program class needs to be test-accessible — top-level statements generate an internal Program by default. Add to the service's API project:

public partial class Program { }