Csag.Blueprint.Testing 0.3.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Csag.Blueprint.Testing --version 0.3.0
                    


                    

                
NuGet\Install-Package Csag.Blueprint.Testing -Version 0.3.0
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.
For projects that support PackageReference, copy this XML node into the project file to reference the package. 

                    


                            Directory.Packages.props
                        

                    

                

                    


                            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 Csag.Blueprint.Testing --version 0.3.0
                    


                    

                
#r "nuget: Csag.Blueprint.Testing, 0.3.0"
#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. 
#:package Csag.Blueprint.Testing@0.3.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Csag.Blueprint.Testing&version=0.3.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Csag.Blueprint.Testing&version=0.3.0
                    


                            Install as a Cake Tool

Csag.Blueprint.Testing

Overview

This package provides shared test infrastructure for CSAG Blueprint-based applications: Testcontainer orchestrators for SQL Server and WireMock, a base class for integration tests with per-test database reset, and unit test helpers.

Integration Testing

MsSqlTestContainerOrchestrator

Manages the full lifecycle of a SQL Server Testcontainer (default image: mcr.microsoft.com/mssql/server:2022-latest). After seeding, it creates a database snapshot that is restored before each test for fast, isolated runs.

Typical usage in a fixture:

// PreSetupAsync
await sqlOrchestrator.StartAsync();

// After migrations and seeding
await sqlOrchestrator.CreateSnapshotAsync(connectionString);

// Before each test (called by IntegrationTestBase)
await sqlOrchestrator.ResetDatabaseAsync();

// TearDownAsync
await sqlOrchestrator.DropSnapshotAsync();
await sqlOrchestrator.DisposeAsync();

WireMockTestContainerOrchestrator

Manages a WireMock Testcontainer for stubbing external HTTP dependencies. Provides GetPublicUri() to override service base URIs in configuration and CreateFreshAdminClientAsync() to reset all stubs at the start of each test.

IntegrationTestBase

Abstract base class for integration tests. Calls TFixture.ResetDatabaseAsync() in SetupAsync() so every test starts from the post-seeding snapshot. The fixture must implement IResettableFixture.

IResettableFixture

Interface marking a test fixture as supporting per-test database reset. Implementations should delegate to MsSqlTestContainerOrchestrator.ResetDatabaseAsync().

Unit Testing

AutoDomainDataAttribute

An [AutoData] attribute configured for domain entities. Replaces AutoFixture's default ThrowingRecursionBehavior with OmitOnRecursionBehavior so entity graphs with circular navigation properties can be auto-generated.

TestDbContextScope

Disposable wrapper around a DbContext instance that ensures proper cleanup when disposed. Useful for scoping a test-local context.

Assertion Extensions

HttpResponseMessageExtensions

Shouldly-style assertion for HTTP responses:

await response.ShouldHaveStatusCodeAsync(HttpStatusCode.OK);

On failure, the assertion message includes the full response body for easier debugging.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.3.0 560 9/15/2026
0.2.0 214 9/8/2026
0.1.3 475 8/20/2026
0.1.2 138 8/19/2026
0.1.1 111 8/13/2026
0.1.0 134 7/3/2026