👁 Image
TestTrackingDiagrams.Extensions.EfCore.Relational 2.37.4

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

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

Extensions

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:

• Quick Start (xUnit)
• Framework Integration Guides
• HTTP Tracking Setup
• Diagram Customisation
• Report Configuration
• API Reference
• Example Project