QueryGuard.Testing 0.1.0-preview.1

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of QueryGuard.Testing.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package QueryGuard.Testing --version 0.1.0-preview.1
                    


                    

                
NuGet\Install-Package QueryGuard.Testing -Version 0.1.0-preview.1
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="QueryGuard.Testing" Version="0.1.0-preview.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="QueryGuard.Testing" Version="0.1.0-preview.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="QueryGuard.Testing" />
                    


                            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 QueryGuard.Testing --version 0.1.0-preview.1
                    


                    

                
#r "nuget: QueryGuard.Testing, 0.1.0-preview.1"
#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 QueryGuard.Testing@0.1.0-preview.1
#: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=QueryGuard.Testing&version=0.1.0-preview.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=QueryGuard.Testing&version=0.1.0-preview.1&prerelease
                    


                            Install as a Cake Tool

QueryGuard.Testing

Turn database behaviour into an assertion. Open a QueryGuard.NET scope around the code under test and check that its query budget held.

[Fact]
public async Task Companies_endpoint_stays_within_its_query_budget()
{
    await using var scope = QueryGuardScope.Start(
        "GET /api/companies",
        QueryGuardPolicy.Create("companies")
            .WithMaxQueries(3)
            .WithMaxOccurrencesPerFingerprint(1));

    var response = await client.GetAsync("/api/companies");
    response.EnsureSuccessStatusCode();

    QueryGuardAssert.Passes(await scope.CompleteAsync());
}

The scope and the interceptor must share an accessor

The example above relies on both using QueryGuardScope.DefaultAccessor. If your interceptor came from a dependency injection container, pass that container's accessor to the scope instead:

accessor: services.GetRequiredService<IQueryGuardSessionAccessor>()

Get this wrong and the scope completes with zero commands, so every count assertion fails for a reason unrelated to the code under test. With WebApplicationFactory there is a second trap — TestServer does not flow ExecutionContext into requests unless asked, and QueryGuard finds the active session through AsyncLocal. Both are covered in troubleshooting.

No test framework dependency

This package references no test framework. QueryGuardAssert throws QueryGuardBudgetExceededException, and every test framework reports an unexpected exception with its message — so xUnit, NUnit, MSTest, and TUnit all work unchanged, and installing this package does not drag a framework into your project.

Because there is no framework-native formatting to lean on, the exception message carries the evidence: the policy, expected against actual, the top repeated fingerprint with its redacted SQL, any ignored findings, and where to read about false positives. See ADR-0010.

Prefer your own assertions? CompleteAsync returns the QueryGuardResult; assert on it however you like.

Preview

Public APIs may change before 1.0.0. See the changelog.

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 was computed.  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.  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 (1)

Showing the top 1 NuGet packages that depend on QueryGuard.Testing:

Package Downloads
QueryGuard.AspNetCore.Testing

Measure EF Core queries from WebApplicationFactory tests with one setup call. Preserves the test execution context, disables request middleware, and wires the matching session accessor.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0 47 8/21/2026
0.1.0-preview.6 52 8/21/2026
0.1.0-preview.5 47 8/21/2026
0.1.0-preview.4 43 8/20/2026
0.1.0-preview.3 44 8/20/2026
0.1.0-preview.2 37 8/20/2026
0.1.0-preview.1 44 8/20/2026

See https://github.com/Benziza/queryguard-dotnet/blob/main/CHANGELOG.md