Rig.TUnit.Microservices 0.1.0-beta.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of Rig.TUnit.Microservices. 
dotnet add package Rig.TUnit.Microservices --version 0.1.0-beta.2
                    


                    

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


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Rig.TUnit.Microservices" />
                    


                            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 Rig.TUnit.Microservices --version 0.1.0-beta.2
                    


                    

                
#r "nuget: Rig.TUnit.Microservices, 0.1.0-beta.2"
#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 Rig.TUnit.Microservices@0.1.0-beta.2
#: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=Rig.TUnit.Microservices&version=0.1.0-beta.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Rig.TUnit.Microservices&version=0.1.0-beta.2&prerelease
                    


                            Install as a Cake Tool

Rig.TUnit.Microservices

Opinionated microservice-testing meta-package: Core + Mediator + Grpc + Outbox + Inbox + EventSourcing + Snapshots + Saga + Contracts + Tracing + Jwt + Seq.

What this package is

A meta-package wired for the full CQRS / event-sourcing microservice stack Rig.TUnit is built around. Install this one NuGet and you get the command side (outbox relay, idempotency), query side (inbox + snapshotting), contract verification, saga harness, distributed tracing, and JWT-authenticated gRPC client helpers in one using block.

Prefer this over Rig.TUnit.All when your repo is a microservice; use Rig.TUnit when it is just a web API.

When to use it

  • Writing integration tests for an event-sourced microservice.
  • Validating pact-style contract suites against a real gRPC/HTTP surface.
  • Orchestrating saga-step assertions across multiple aggregates.
  • Not for: a monolithic ASP.NET Core MVC app — Rig.TUnit is smaller.

Prerequisites

  • .NET 10 SDK
  • Docker Desktop / Colima (any transitively-referenced provider you use)

Quick start

using Rig.TUnit.Core.Builder;
using Rig.TUnit.Core.Helpers;

var rig = new RigBuilder()
    .WithIsolation(IsolationKey.FromExecutionContext())
    .Build();

await using var _ = rig;

Options

§6 — N/A: meta-package. Each transitively-referenced package binds its own

options section (RigTUnit:Outbox, RigTUnit:Inbox, RigTUnit:Grpc, etc.).

Fixture + helper APIs

Every public API from the referenced packages is exposed; see their READMEs:

Per-test isolation

Delegated to each referenced package. The IsolationKey threaded through RigBuilder shows up in outbox relay IDs, inbox dedup keys, saga harness correlation IDs, and gRPC trace tags.

Parallelism + performance

§9 — N/A: meta-package; see individual package READMEs for per-feature

parallelism cost. Outbox + Inbox are typically the hot paths.

Troubleshooting

  • Version drift across referenced packages — this meta-package pins every dependency version; do not re-declare <PackageVersion> entries in consuming projects.

See docs/troubleshooting.md.

Provider quirks + edge cases

§11 — N/A: meta-package; quirks are in each leaf README.

Benchmarks

§12 — N/A: meta-package. Transitively-referenced packages have their own

entries in tests/Rig.TUnit.Benchmarks/ and benchmarks/baseline-005.json.

License

MIT. See LICENSE.

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.1.0-beta.2 43 4/27/2026
0.0.0-alpha.0.14 44 4/26/2026