TestTrackingDiagrams 2.0.159-beta

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of TestTrackingDiagrams.
There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package TestTrackingDiagrams --version 2.0.159-beta
                    


                    

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


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="TestTrackingDiagrams" />
                    


                            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 TestTrackingDiagrams --version 2.0.159-beta
                    


                    

                
#r "nuget: TestTrackingDiagrams, 2.0.159-beta"
#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 TestTrackingDiagrams@2.0.159-beta
#: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=TestTrackingDiagrams&version=2.0.159-beta&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=TestTrackingDiagrams&version=2.0.159-beta&prerelease
                    


                            Install as a Cake Tool

TestTrackingDiagrams

Effortlessly autogenerate PlantUML sequence diagrams from your component and acceptance tests. Tracks interactions between your test caller, your Service Under Test (SUT), and its dependencies — including HTTP calls, Azure Cosmos DB operations, SQL queries (via EF Core), Redis commands, events/messages, and arbitrary method calls — then converts them into diagrams embedded in searchable HTML reports and structured data files.

Example Output

Example sequence diagram

Each test that uses tracked dependencies automatically produces a sequence diagram showing the full request/response flow between services.

How It Works

  1. Intercept — Dedicated tracking mechanisms intercept each type of dependency: TestTrackingMessageHandler for HTTP, CosmosTrackingMessageHandler for Cosmos DB, SqlTrackingInterceptor for EF Core SQL, RedisTrackingDatabase for Redis, TrackingProxy<T> for arbitrary interfaces, and MessageTracker for events/messages.
  2. Collect — All logged entries are held in the static RequestResponseLogger, capturing operation details, service names, and trace IDs.
  3. Generate — At the end of the test run, PlantUmlCreator groups logs by test ID and converts them into sequence diagram code.
  4. Report — ReportGenerator combines the diagrams with test metadata to produce HTML reports and structured data files.

Quick Start

dotnet add package TestTrackingDiagrams.xUnit3

See the Quick Start guide for full setup instructions.

Supported Frameworks

Framework Package
Core library TestTrackingDiagrams
xUnit v3 TestTrackingDiagrams.xUnit3
xUnit v2 TestTrackingDiagrams.xUnit2
NUnit v4 TestTrackingDiagrams.NUnit4
MSTest v3 TestTrackingDiagrams.MSTest
TUnit TestTrackingDiagrams.TUnit
BDDfy TestTrackingDiagrams.BDDfy.xUnit3
LightBDD TestTrackingDiagrams.LightBDD.xUnit3 / .xUnit2 / .TUnit
ReqNRoll TestTrackingDiagrams.ReqNRoll.xUnit3 / .xUnit2 / .TUnit

Extensions

Extension Package
Azure Cosmos DB TestTrackingDiagrams.Extensions.CosmosDB
EF Core (Relational) TestTrackingDiagrams.Extensions.EfCore.Relational
Redis TestTrackingDiagrams.Extensions.Redis
Local PlantUML (IKVM) TestTrackingDiagrams.PlantUml.Ikvm

Use Cases

  • Debugging failed tests — see the exact interaction that returned an unexpected result
  • Living documentation — HTML reports and data files that stay in sync with your tests
  • AI-assisted analysis — feed deterministic PlantUML to AI tools for accurate reasoning
  • PR reviews — sequence diagrams make interaction changes immediately visible
  • Onboarding — new team members can browse reports to understand service interactions
  • CI integration — surface results in GitHub Actions / Azure DevOps job summaries

Documentation

For full documentation, see the Wiki.

Key pages:

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 is compatible.  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 (19)

Showing the top 5 NuGet packages that depend on TestTrackingDiagrams:

Package Downloads
TestTrackingDiagrams.PlantUml.Ikvm

Local PlantUML rendering via IKVM for TestTrackingDiagrams. Generates diagrams without requiring a remote PlantUML server.
TestTrackingDiagrams.NUnit4

NUnit 4 extensions for tracking service interactions (HTTP, database, cache, events, and more) in your tests and converting them into PlantUML sequence diagrams. This is the renamed successor to TestTrackingDiagrams.NUnit3.
TestTrackingDiagrams.BDDfy.xUnit3

BDDfy + xUnit v3 extensions for tracking service interactions (HTTP, database, cache, events, and more) in your tests and converting them into PlantUML sequence diagrams.
TestTrackingDiagrams.xUnit3

xUnit v3 extensions for tracking service interactions (HTTP, database, cache, events, and more) in your tests and converting them into PlantUML sequence diagrams.
TestTrackingDiagrams.xUnit2

xUnit v2 extensions for tracking service interactions (HTTP, database, cache, events, and more) in your tests and converting them into PlantUML sequence diagrams.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.169-beta 0 4/20/2026
2.0.168-beta 0 4/20/2026
2.0.167-beta 0 4/20/2026
2.0.166-beta 0 4/20/2026
2.0.165-beta 0 4/20/2026
2.0.164-beta 0 4/20/2026
2.0.163-beta 0 4/20/2026
2.0.162-beta 0 4/19/2026
2.0.161-beta 3 4/19/2026
2.0.160-beta 22 4/19/2026
2.0.159-beta 27 4/19/2026
2.0.158-beta 23 4/19/2026
2.0.157-beta 25 4/19/2026
2.0.156-beta 25 4/19/2026
2.0.155-beta 29 4/19/2026
2.0.154-beta 43 4/18/2026
2.0.153-beta 33 4/18/2026
2.0.152-beta 46 4/18/2026
1.26.0 318 4/3/2026
Loading failed