DemaConsulting.TestResults 1.9.0

TestResults

.NET library for TRX and JUnit test results

Overview

A .NET library for reading and writing test result files in multiple formats. Provides an in-memory model for test outcomes and results, supporting serialization to/from TRX (Visual Studio Test Results) and JUnit XML formats.

Features

• ✨ Simple API - Intuitive and easy-to-use object model for test results
• 🎯 Type-Safe - Strongly-typed C# classes for test outcomes and results
• 🪶 Lightweight - Zero runtime dependencies
• 🔄 Multi-Target - Supports .NET Standard 2.0, .NET 8, 9, and 10
• 📦 NuGet Ready - Easy integration via NuGet package
• 📊 Multiple Formats - Supports both TRX and JUnit XML formats
• ✅ Compatible - Works with Visual Studio, Azure DevOps, and CI/CD systems
• 🔒 Continuous Compliance - Compliance evidence generated automatically on every CI run, following the Continuous Compliance methodology

Installation

dotnet add package DemaConsulting.TestResults

Or via Package Manager Console:

Install-Package DemaConsulting.TestResults

Usage

using DemaConsulting.TestResults;
using DemaConsulting.TestResults.IO;

// Create a TestResults instance
var results = new TestResults { Name = "SomeTests" };

// Add test results
results.Results.Add(new TestResult
{
    Name = "Test1",
    ClassName = "SomeTestClass",
    CodeBase = "MyTestAssembly",
    Outcome = TestOutcome.Passed,
    Duration = TimeSpan.FromSeconds(1.5),
    StartTime = DateTime.UtcNow
});

results.Results.Add(new TestResult
{
    Name = "Test2",
    ClassName = "SomeTestClass",
    CodeBase = "MyTestAssembly",
    Outcome = TestOutcome.Failed,
    ErrorMessage = "Expected value to be 42 but was 0",
    ErrorStackTrace = "at SomeTestClass.Test2() in Test.cs:line 15"
});

// Save as TRX (Visual Studio format)
File.WriteAllText("results.trx", TrxSerializer.Serialize(results));

// Save as JUnit XML
File.WriteAllText("results.xml", JUnitSerializer.Serialize(results));

The library can automatically detect and convert between formats:

using DemaConsulting.TestResults.IO;

// Automatically detect and deserialize any supported format
var results = Serializer.Deserialize(File.ReadAllText("test-results.xml"));

// Convert JUnit to TRX
var junitResults = JUnitSerializer.Deserialize(File.ReadAllText("junit-results.xml"));
File.WriteAllText("converted.trx", TrxSerializer.Serialize(junitResults));

Test Outcomes

The library supports the following test outcomes via the TestOutcome enum:

Successful: Passed, PassedButRunAborted, Warning

Failure: Failed, Error, Timeout, Aborted

Skipped/Not Run: NotExecuted, NotRunnable, Pending

Other: Completed, Inconclusive, Disconnected, InProgress

Helper extension methods: IsPassed(), IsFailed(), IsExecuted()

Building

pwsh ./build.ps1

API Documentation

Detailed API documentation for all public types and members is distributed in the api/ folder of the NuGet package.

User Guide

The TestResults User Guide is available on the TestResults releases page.

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License — see LICENSE.

Support

• Report a bug or request a feature
• Ask a question or start a discussion