🚀 The Modern Testing Framework for .NET

TUnit is a next-generation testing framework for C# that outpaces traditional frameworks with source-generated tests, parallel execution by default, and Native AOT support. Built on the modern Microsoft.Testing.Platform, TUnit delivers faster test runs, better developer experience, and unmatched flexibility.

⚡ Why Choose TUnit?

Feature	Traditional Frameworks	TUnit
Test Discovery	❌ Runtime reflection	✅ Compile-time generation
Execution Speed	❌ Sequential by default	✅ Parallel by default
Modern .NET	⚠️ Limited AOT support	✅ Full Native AOT & trimming
Test Dependencies	❌ Not supported	✅ `[DependsOn]` chains
Resource Management	❌ Manual lifecycle	✅ Intelligent cleanup

⚡ Parallel by Default - Tests run concurrently with intelligent dependency management

🎯 Compile-Time Discovery - Know your test structure before runtime

🔧 Modern .NET Ready - Native AOT, trimming, and latest .NET features

🎭 Extensible - Customize data sources, attributes, and test behavior

📚 Complete Documentation & Learning Center

🚀 New to TUnit? Start with our Getting Started Guide

🔄 Migrating? See our Migration Guides

🎯 Advanced Features? Explore Data-Driven Testing, Test Dependencies, and Parallelism Control

🏁 Quick Start

Using the Project Template (Recommended)

dotnet new install TUnit.Templates
dotnet new TUnit -n "MyTestProject"

Manual Installation

dotnet add package TUnit --prerelease

📖 📚 Complete Documentation & Guides - Everything you need to master TUnit

✨ Key Features

🚀 Performance & Modern Platform

🔥 Source-generated tests (no reflection)
⚡ Parallel execution by default
🚀 Native AOT & trimming support
📈 Optimized for performance

🎯 Advanced Test Control

🔗 Test dependencies with [DependsOn]
🎛️ Parallel limits & custom scheduling
🛡️ Built-in analyzers & compile-time checks
🎭 Custom attributes & extensible conditions

📊 Rich Data & Assertions

📋 Multiple data sources ([Arguments], [Matrix], [ClassData])
✅ Fluent async assertions
🔄 Smart retry logic & conditional execution
📝 Rich test metadata & context

🔧 Developer Experience

💉 Full dependency injection support
🪝 Comprehensive lifecycle hooks
🎯 IDE integration (VS, Rider, VS Code)
📚 Extensive documentation & examples

📝 Simple Test Example

[Test]
public async Task User_Creation_Should_Set_Timestamp()
{
    // Arrange
    var userService = new UserService();

    // Act
    var user = await userService.CreateUserAsync("[email protected]");

    // Assert - TUnit's fluent assertions
    await Assert.That(user.CreatedAt)
        .IsEqualTo(DateTime.Now)
        .Within(TimeSpan.FromMinutes(1));

    await Assert.That(user.Email)
        .IsEqualTo("[email protected]");
}

🎯 Data-Driven Testing

[Test]
[Arguments("[email protected]", "ValidPassword123")]
[Arguments("[email protected]", "AnotherPassword456")]
[Arguments("[email protected]", "AdminPass789")]
public async Task User_Login_Should_Succeed(string email, string password)
{
    var result = await authService.LoginAsync(email, password);
    await Assert.That(result.IsSuccess).IsTrue();
}

// Matrix testing - tests all combinations
[Test]
[MatrixDataSource]
public async Task Database_Operations_Work(
    [Matrix("Create", "Update", "Delete")] string operation,
    [Matrix("User", "Product", "Order")] string entity)
{
    await Assert.That(await ExecuteOperation(operation, entity))
        .IsTrue();
}

🔗 Advanced Test Orchestration

[Before(Class)]
public static async Task SetupDatabase(ClassHookContext context)
{
    await DatabaseHelper.InitializeAsync();
}

[Test, DisplayName("Register a new account")]
[MethodDataSource(nameof(GetTestUsers))]
public async Task Register_User(string username, string password)
{
    // Test implementation
}

[Test, DependsOn(nameof(Register_User))]
[Retry(3)] // Retry on failure
public async Task Login_With_Registered_User(string username, string password)
{
    // This test runs after Register_User completes
}

[Test]
[ParallelLimit<LoadTestParallelLimit>] // Custom parallel control
[Repeat(100)] // Run 100 times
public async Task Load_Test_Homepage()
{
    // Performance testing
}

// Custom attributes
[Test, WindowsOnly, RetryOnHttpError(5)]
public async Task Windows_Specific_Feature()
{
    // Platform-specific test with custom retry logic
}

public class LoadTestParallelLimit : IParallelLimit
{
    public int Limit => 10; // Limit to 10 concurrent executions
}

🔧 Smart Test Control

// Custom conditional execution
public class WindowsOnlyAttribute : SkipAttribute
{
    public WindowsOnlyAttribute() : base("Windows only test") { }

    public override Task<bool> ShouldSkip(TestContext testContext)
        => Task.FromResult(!OperatingSystem.IsWindows());
}

// Custom retry logic
public class RetryOnHttpErrorAttribute : RetryAttribute
{
    public RetryOnHttpErrorAttribute(int times) : base(times) { }

    public override Task<bool> ShouldRetry(TestInformation testInformation,
        Exception exception, int currentRetryCount)
        => Task.FromResult(exception is HttpRequestException { StatusCode: HttpStatusCode.ServiceUnavailable });
}

🎯 Perfect For Every Testing Scenario

🧪 Unit Testing

[Test]
[Arguments(1, 2, 3)]
[Arguments(5, 10, 15)]
public async Task Calculate_Sum(int a, int b, int expected)
{
    await Assert.That(Calculator.Add(a, b))
        .IsEqualTo(expected);
}

Fast, isolated, and reliable

🔗 Integration Testing

[Test, DependsOn(nameof(CreateUser))]
public async Task Login_After_Registration()
{
    // Runs after CreateUser completes
    var result = await authService.Login(user);
    await Assert.That(result.IsSuccess).IsTrue();
}

Stateful workflows made simple

⚡ Load Testing

[Test]
[ParallelLimit<LoadTestLimit>]
[Repeat(1000)]
public async Task API_Handles_Concurrent_Requests()
{
    await Assert.That(await httpClient.GetAsync("/api/health"))
        .HasStatusCode(HttpStatusCode.OK);
}

Built-in performance testing

🚀 What Makes TUnit Different?

Compile-Time Intelligence

Tests are discovered at build time, not runtime - enabling faster discovery, better IDE integration, and precise resource lifecycle management.

Parallel-First Architecture

Built for concurrency from day one with [DependsOn] for test chains, [ParallelLimit] for resource control, and intelligent scheduling.

Extensible by Design

The DataSourceGenerator<T> pattern and custom attribute system let you extend TUnit's capabilities without modifying core framework code.

🏆 Community & Ecosystem

🌟 Join thousands of developers modernizing their testing

🤝 Active Community

📚 Official Documentation - Comprehensive guides, tutorials, and API reference
💬 GitHub Discussions - Get help and share ideas
🐛 Issue Tracking - Report bugs and request features
📢 Release Notes - Stay updated with latest improvements

🛠️ IDE Support

TUnit works seamlessly across all major .NET development environments:

Visual Studio (2022 17.13+)

✅ Fully supported - No additional configuration needed for latest versions

⚙️ Earlier versions: Enable "Use testing platform server mode" in Tools > Manage Preview Features

JetBrains Rider

✅ Fully supported

⚙️ Setup: Enable "Testing Platform support" in Settings > Build, Execution, Deployment > Unit Testing > VSTest

Visual Studio Code

✅ Fully supported

⚙️ Setup: Install C# Dev Kit and enable "Use Testing Platform Protocol"

Command Line

✅ Full CLI support - Works with dotnet test, dotnet run, and direct executable execution

📦 Package Options

Package	Use Case
`TUnit`	⭐ Start here - Complete testing framework (includes Core + Engine + Assertions)
`TUnit.Core`	📚 Test libraries and shared components (no execution engine)
`TUnit.Engine`	🚀 Test execution engine and adapter (for test projects)
`TUnit.Assertions`	✅ Standalone assertions (works with any test framework)
`TUnit.Playwright`	🎭 Playwright integration with automatic lifecycle management

🎯 Migration from Other Frameworks

Coming from NUnit or xUnit? TUnit maintains familiar syntax while adding modern capabilities:

// Enhanced with TUnit's advanced features
[Test]
[Arguments("value1")]
[Arguments("value2")]
[Retry(3)]
[ParallelLimit<CustomLimit>]
public async Task Modern_TUnit_Test(string value) { }

📖 Need help migrating? Check our detailed Migration Guides with step-by-step instructions for xUnit, NUnit, and MSTest.

💡 Current Status

The API is mostly stable, but may have some changes based on feedback or issues before v1.0 release.

🚀 Ready to Experience the Future of .NET Testing?

⚡ Start in 30 Seconds

# Create a new test project with examples
dotnet new install TUnit.Templates && dotnet new TUnit -n "MyAwesomeTests"

# Or add to existing project
dotnet add package TUnit --prerelease

🎯 Why Wait? Join the Movement

📈 Performance

Optimized execution Parallel by default Zero reflection overhead

🔮 Future-Ready

Native AOT support Latest .NET features Source generation

🛠️ Developer Experience

Compile-time checks Rich IDE integration Intelligent debugging

🎭 Flexibility

Test dependencies Custom attributes Extensible architecture

📖 Learn More: tunit.dev | 💬 Get Help: GitHub Discussions | ⭐ Show Support: Star on GitHub

TUnit is actively developed and production-ready. Join our growing community of developers who've made the switch!

Performance Benchmark

Scenario: Building the test project

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
Build_TUnit	0.63.3	1,346.0 ms	102.51 ms	302.26 ms	1,336.2 ms
Build_NUnit	4.4.0	1,002.1 ms	35.78 ms	104.94 ms	967.9 ms
Build_xUnit	2.9.3	955.1 ms	35.11 ms	103.51 ms	918.0 ms
Build_MSTest	3.11.0	993.3 ms	26.75 ms	78.46 ms	971.7 ms

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.60GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
Build_TUnit	0.63.3	1.700 s	0.0271 s	0.0240 s	1.700 s
Build_NUnit	4.4.0	1.504 s	0.0173 s	0.0153 s	1.506 s
Build_xUnit	2.9.3	1.522 s	0.0176 s	0.0164 s	1.524 s
Build_MSTest	3.11.0	1.540 s	0.0117 s	0.0109 s	1.538 s

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
Build_TUnit	0.63.3	1.832 s	0.0351 s	0.0312 s	1.824 s
Build_NUnit	4.4.0	1.647 s	0.0159 s	0.0141 s	1.645 s
Build_xUnit	2.9.3	1.665 s	0.0255 s	0.0381 s	1.659 s
Build_MSTest	3.11.0	1.884 s	0.0362 s	0.0355 s	1.875 s

Scenario: Tests focused on assertion performance and validation

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	402.75 ms	20.422 ms	58.59 ms	385.36 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	1,125.10 ms	65.088 ms	188.83 ms	1,114.66 ms
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	57.10 ms	7.653 ms	22.57 ms	49.85 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	489.46 ms	4.035 ms	3.577 ms	490.20 ms
NUnit	4.4.0	929.93 ms	18.061 ms	16.894 ms	932.54 ms
xUnit	2.9.3	1,002.77 ms	15.109 ms	14.133 ms	1,004.96 ms
MSTest	3.11.0	863.74 ms	16.596 ms	19.757 ms	857.34 ms
TUnit_AOT	0.63.3	25.92 ms	0.315 ms	0.263 ms	25.89 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	520.55 ms	2.297 ms	2.036 ms	520.18 ms
NUnit	4.4.0	987.03 ms	15.900 ms	14.873 ms	991.47 ms
xUnit	2.9.3	1,071.05 ms	14.745 ms	13.792 ms	1,068.10 ms
MSTest	3.11.0	921.46 ms	17.698 ms	17.382 ms	930.76 ms
TUnit_AOT	0.63.3	64.03 ms	1.912 ms	5.639 ms	63.75 ms

Scenario: Tests running asynchronous operations and async/await patterns

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	332.2 ms	15.92 ms	46.69 ms	324.3 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	113.1 ms	10.45 ms	30.49 ms	110.4 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	447.38 ms	3.802 ms	3.556 ms	447.93 ms
NUnit	4.4.0	930.01 ms	13.051 ms	11.569 ms	929.11 ms
xUnit	2.9.3	1,013.97 ms	18.466 ms	17.273 ms	1,008.88 ms
MSTest	3.11.0	869.65 ms	16.762 ms	16.462 ms	873.70 ms
TUnit_AOT	0.63.3	27.86 ms	0.543 ms	0.706 ms	27.98 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	498.70 ms	9.778 ms	9.603 ms	496.02 ms
NUnit	4.4.0	1,019.51 ms	18.140 ms	32.711 ms	1,013.54 ms
xUnit	2.9.3	1,103.27 ms	21.408 ms	27.074 ms	1,102.47 ms
MSTest	3.11.0	965.00 ms	18.495 ms	21.299 ms	969.88 ms
TUnit_AOT	0.63.3	90.34 ms	2.611 ms	7.616 ms	91.20 ms

Scenario: Simple tests with basic operations and assertions

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	354.81 ms	13.59 ms	39.64 ms	348.07 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	76.77 ms	11.33 ms	32.68 ms	67.92 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.63GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	473.30 ms	3.362 ms	3.145 ms	473.24 ms
NUnit	4.4.0	941.03 ms	14.302 ms	13.378 ms	940.43 ms
xUnit	2.9.3	1,011.82 ms	14.815 ms	13.858 ms	1,012.26 ms
MSTest	3.11.0	869.36 ms	17.261 ms	17.726 ms	868.79 ms
TUnit_AOT	0.63.3	26.40 ms	0.230 ms	0.204 ms	26.33 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	511.89 ms	2.859 ms	2.535 ms	511.34 ms
NUnit	4.4.0	1,002.86 ms	19.305 ms	18.960 ms	996.69 ms
xUnit	2.9.3	1,065.21 ms	13.177 ms	12.326 ms	1,058.46 ms
MSTest	3.11.0	937.14 ms	17.428 ms	16.302 ms	934.21 ms
TUnit_AOT	0.63.3	64.71 ms	1.907 ms	5.624 ms	64.12 ms

Scenario: Parameterized tests with multiple test cases using data attributes

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	402.58 ms	27.497 ms	81.07 ms	378.05 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	42.67 ms	4.734 ms	13.81 ms	36.05 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	481.70 ms	6.874 ms	6.430 ms	481.66 ms
NUnit	4.4.0	966.76 ms	19.317 ms	25.118 ms	967.49 ms
xUnit	2.9.3	1,046.16 ms	19.480 ms	20.005 ms	1,041.59 ms
MSTest	3.11.0	891.85 ms	17.776 ms	21.161 ms	885.90 ms
TUnit_AOT	0.63.3	28.51 ms	0.600 ms	1.749 ms	27.93 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	548.31 ms	10.702 ms	15.348 ms	545.94 ms
NUnit	4.4.0	1,076.98 ms	21.307 ms	38.421 ms	1,079.33 ms
xUnit	2.9.3	1,170.66 ms	22.891 ms	26.361 ms	1,166.09 ms
MSTest	3.11.0	1,008.69 ms	19.674 ms	27.581 ms	1,016.06 ms
TUnit_AOT	0.63.3	70.41 ms	1.527 ms	4.477 ms	69.67 ms

Scenario: Tests utilizing class fixtures and shared test context

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	291.33 ms	6.104 ms	17.71 ms	290.69 ms
NUnit	4.4.0	799.88 ms	41.431 ms	121.51 ms	804.49 ms
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	666.85 ms	28.241 ms	82.38 ms	657.50 ms
TUnit_AOT	0.63.3	71.33 ms	9.884 ms	28.99 ms	65.65 ms

Benchmarks with issues: RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	448.01 ms	2.992 ms	2.652 ms	447.89 ms
NUnit	4.4.0	915.91 ms	17.502 ms	17.973 ms	919.92 ms
xUnit	2.9.3	995.92 ms	14.810 ms	12.367 ms	995.32 ms
MSTest	3.11.0	857.73 ms	16.219 ms	15.929 ms	863.63 ms
TUnit_AOT	0.63.3	36.03 ms	1.598 ms	4.637 ms	35.34 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	500.43 ms	2.770 ms	2.455 ms	500.20 ms
NUnit	4.4.0	1,004.14 ms	17.623 ms	16.485 ms	1,000.19 ms
xUnit	2.9.3	1,072.77 ms	12.812 ms	11.985 ms	1,070.64 ms
MSTest	3.11.0	1,023.48 ms	19.995 ms	33.953 ms	1,022.58 ms
TUnit_AOT	0.63.3	87.33 ms	1.742 ms	5.082 ms	87.71 ms

Scenario: Tests executing in parallel to test framework parallelization

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	303.57 ms	5.981 ms	8.952 ms	303.54 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	66.60 ms	9.379 ms	27.653 ms	67.03 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.87GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	460.80 ms	6.094 ms	5.700 ms	457.62 ms
NUnit	4.4.0	969.84 ms	19.388 ms	24.519 ms	962.12 ms
xUnit	2.9.3	1,050.23 ms	14.120 ms	11.791 ms	1,051.04 ms
MSTest	3.11.0	892.29 ms	16.850 ms	20.694 ms	896.15 ms
TUnit_AOT	0.63.3	26.49 ms	0.274 ms	0.243 ms	26.50 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	482.65 ms	2.542 ms	2.378 ms	481.51 ms
NUnit	4.4.0	994.66 ms	19.759 ms	18.483 ms	998.08 ms
xUnit	2.9.3	1,072.69 ms	20.977 ms	27.276 ms	1,067.78 ms
MSTest	3.11.0	983.74 ms	26.882 ms	79.261 ms	946.07 ms
TUnit_AOT	0.63.3	62.76 ms	1.554 ms	4.559 ms	62.22 ms

Scenario: A test that takes 50ms to execute, repeated 100 times

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	522.66 ms	30.419 ms	88.25 ms	512.29 ms
NUnit	4.4.0	1,142.95 ms	117.331 ms	345.95 ms	1,080.84 ms
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	53.51 ms	4.830 ms	14.09 ms	50.41 ms

Benchmarks with issues: RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 3.24GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	475.37 ms	4.116 ms	3.850 ms	475.30 ms
NUnit	4.4.0	907.50 ms	17.638 ms	16.499 ms	915.61 ms
xUnit	2.9.3	1,055.37 ms	17.111 ms	16.005 ms	1,050.23 ms
MSTest	3.11.0	835.46 ms	16.395 ms	16.836 ms	839.80 ms
TUnit_AOT	0.63.3	38.93 ms	0.145 ms	0.129 ms	38.95 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	533.00 ms	3.868 ms	3.230 ms	533.33 ms
NUnit	4.4.0	1,013.72 ms	13.752 ms	12.864 ms	1,014.08 ms
xUnit	2.9.3	1,168.13 ms	18.339 ms	17.154 ms	1,164.24 ms
MSTest	3.11.0	941.24 ms	18.608 ms	19.109 ms	942.58 ms
TUnit_AOT	0.63.3	74.13 ms	0.667 ms	0.592 ms	74.10 ms

Scenario: Tests with setup and teardown lifecycle methods

macos-latest


BenchmarkDotNet v0.15.4, macOS Sequoia 15.6.1 (24G90) [Darwin 24.6.0]
Apple M1 (Virtual), 1 CPU, 3 logical and 3 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), Arm64 RyuJIT armv8.0-a

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	332.97 ms	13.704 ms	40.19 ms	325.60 ms
NUnit	4.4.0	NA	NA	NA	NA
xUnit	2.9.3	NA	NA	NA	NA
MSTest	3.11.0	NA	NA	NA	NA
TUnit_AOT	0.63.3	63.07 ms	7.661 ms	21.61 ms	57.15 ms

Benchmarks with issues: RuntimeBenchmarks.NUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.xUnit: Job-YNJDZW(Runtime=.NET 9.0) RuntimeBenchmarks.MSTest: Job-YNJDZW(Runtime=.NET 9.0)

ubuntu-latest


BenchmarkDotNet v0.15.4, Linux Ubuntu 24.04.3 LTS (Noble Numbat)
AMD EPYC 7763 2.45GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	461.16 ms	3.478 ms	3.254 ms	461.39 ms
NUnit	4.4.0	929.10 ms	14.767 ms	13.813 ms	927.05 ms
xUnit	2.9.3	1,014.42 ms	16.745 ms	15.663 ms	1,011.61 ms
MSTest	3.11.0	869.06 ms	16.420 ms	16.126 ms	866.79 ms
TUnit_AOT	0.63.3	26.84 ms	0.314 ms	0.278 ms	26.83 ms

windows-latest


BenchmarkDotNet v0.15.4, Windows 11 (10.0.26100.6584/24H2/2024Update/HudsonValley) (Hyper-V)
AMD EPYC 7763 2.44GHz, 1 CPU, 4 logical and 2 physical cores
.NET SDK 9.0.305
  [Host]     : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3
  Job-YNJDZW : .NET 9.0.9 (9.0.9, 9.0.925.41916), X64 RyuJIT x86-64-v3

Runtime=.NET 9.0

Method	Version	Mean	Error	StdDev	Median
TUnit	0.63.3	520.44 ms	10.331 ms	24.147 ms	519.28 ms
NUnit	4.4.0	1,047.16 ms	20.503 ms	21.055 ms	1,047.53 ms
xUnit	2.9.3	1,134.35 ms	21.933 ms	26.936 ms	1,131.77 ms
MSTest	3.11.0	984.42 ms	17.315 ms	24.273 ms	983.95 ms
TUnit_AOT	0.63.3	69.66 ms	1.929 ms	5.565 ms	69.67 ms

Name		Name	Last commit message	Last commit date
Latest commit History 4,076 Commits
.claude/commands		.claude/commands
.config		.config
.github		.github
.idea/.idea.TUnit/.idea		.idea/.idea.TUnit/.idea
.serena		.serena
.vscode		.vscode
Examples		Examples
Playground		Playground
Snapshots/TUnit._.verified/std-streams		Snapshots/TUnit._.verified/std-streams
TUnit.AOT.Tests		TUnit.AOT.Tests
TUnit.Analyzers.CodeFixers		TUnit.Analyzers.CodeFixers
TUnit.Analyzers.Roslyn414		TUnit.Analyzers.Roslyn414
TUnit.Analyzers.Roslyn44		TUnit.Analyzers.Roslyn44
TUnit.Analyzers.Roslyn47		TUnit.Analyzers.Roslyn47
TUnit.Analyzers.Tests		TUnit.Analyzers.Tests
TUnit.Analyzers		TUnit.Analyzers
TUnit.Assertions.Analyzers.CodeFixers.Tests		TUnit.Assertions.Analyzers.CodeFixers.Tests
TUnit.Assertions.Analyzers.CodeFixers		TUnit.Assertions.Analyzers.CodeFixers
TUnit.Assertions.Analyzers.Tests		TUnit.Assertions.Analyzers.Tests
TUnit.Assertions.Analyzers		TUnit.Assertions.Analyzers
TUnit.Assertions.FSharp		TUnit.Assertions.FSharp
TUnit.Assertions.SourceGenerator.Tests		TUnit.Assertions.SourceGenerator.Tests
TUnit.Assertions.SourceGenerator		TUnit.Assertions.SourceGenerator
TUnit.Assertions.Tests		TUnit.Assertions.Tests
TUnit.Assertions		TUnit.Assertions
TUnit.Core.SourceGenerator.Roslyn414		TUnit.Core.SourceGenerator.Roslyn414
TUnit.Core.SourceGenerator.Roslyn44		TUnit.Core.SourceGenerator.Roslyn44
TUnit.Core.SourceGenerator.Roslyn47		TUnit.Core.SourceGenerator.Roslyn47
TUnit.Core.SourceGenerator.Tests		TUnit.Core.SourceGenerator.Tests
TUnit.Core.SourceGenerator		TUnit.Core.SourceGenerator
TUnit.Core.Tests/Helpers		TUnit.Core.Tests/Helpers
TUnit.Core		TUnit.Core
TUnit.Engine.Tests		TUnit.Engine.Tests
TUnit.Engine		TUnit.Engine
TUnit.Example.Asp.Net.TestProject		TUnit.Example.Asp.Net.TestProject
TUnit.Example.Asp.Net		TUnit.Example.Asp.Net
TUnit.Example		TUnit.Example
TUnit.IntegrationTests		TUnit.IntegrationTests
TUnit.Performance.Tests		TUnit.Performance.Tests
TUnit.Pipeline		TUnit.Pipeline
TUnit.Playwright		TUnit.Playwright
TUnit.PublicAPI		TUnit.PublicAPI
TUnit.RpcTests		TUnit.RpcTests
TUnit.Templates.Tests		TUnit.Templates.Tests
TUnit.Templates		TUnit.Templates
TUnit.TestProject.FSharp		TUnit.TestProject.FSharp
TUnit.TestProject.Library		TUnit.TestProject.Library
TUnit.TestProject.VB.NET		TUnit.TestProject.VB.NET
TUnit.TestProject		TUnit.TestProject
TUnit.UnitTests		TUnit.UnitTests
TUnit		TUnit
assets		assets
docs		docs
tools		tools
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
Analyzer.props		Analyzer.props
CLAUDE.md		CLAUDE.md
Directory.Build.props		Directory.Build.props
Directory.Build.targets		Directory.Build.targets
Directory.Packages.props		Directory.Packages.props
GitVersion.yml		GitVersion.yml
LICENSE		LICENSE
Library.props		Library.props
Library.targets		Library.targets
Polyfill.targets		Polyfill.targets
README.md		README.md
README_Template.md		README_Template.md
Roslyn.props		Roslyn.props
SourceGenerationDebug.props		SourceGenerationDebug.props
SourceGenerator.props		SourceGenerator.props
TUnit-Innovative-Features-Implementation-Plan.md		TUnit-Innovative-Features-Implementation-Plan.md
TUnit.props		TUnit.props
TUnit.sln		TUnit.sln
TestLibrary.props		TestLibrary.props
TestLibrary.targets		TestLibrary.targets
TestProject.props		TestProject.props
TestProject.targets		TestProject.targets
aot_output.txt		aot_output.txt
build_log.txt		build_log.txt
build_output.txt		build_output.txt
debug_output.txt		debug_output.txt
debug_output2.txt		debug_output2.txt
debug_output3.txt		debug_output3.txt
dotnet-install.sh		dotnet-install.sh
dotnet-install.sh.1		dotnet-install.sh.1
global.json		global.json
hook_changes.patch		hook_changes.patch
package.json		package.json
pr_failures.txt		pr_failures.txt
renovate.json		renovate.json
rider.png		rider.png
run-all-engine-tests.ps1		run-all-engine-tests.ps1
run-aot-tests.ps1		run-aot-tests.ps1
run-reflection-tests.ps1		run-reflection-tests.ps1
run-singlefile-tests.ps1		run-singlefile-tests.ps1
run-source-generation-tests-verbose.ps1		run-source-generation-tests-verbose.ps1
run-source-generation-tests.ps1		run-source-generation-tests.ps1
strongname.snk		strongname.snk

Uh oh!

License

thomhurst/TUnit

Folders and files

Latest commit

History

Repository files navigation

🚀 The Modern Testing Framework for .NET

⚡ Why Choose TUnit?

📚 Complete Documentation & Learning Center

🏁 Quick Start

Using the Project Template (Recommended)

Manual Installation

✨ Key Features

📝 Simple Test Example

🎯 Data-Driven Testing

🔗 Advanced Test Orchestration

🔧 Smart Test Control

🎯 Perfect For Every Testing Scenario

🧪 Unit Testing

🔗 Integration Testing

⚡ Load Testing

🚀 What Makes TUnit Different?

Compile-Time Intelligence

Parallel-First Architecture

Extensible by Design

🏆 Community & Ecosystem

🤝 Active Community

🛠️ IDE Support

Visual Studio (2022 17.13+)

JetBrains Rider

Visual Studio Code

Command Line

📦 Package Options

🎯 Migration from Other Frameworks

💡 Current Status

🚀 Ready to Experience the Future of .NET Testing?

⚡ Start in 30 Seconds

🎯 Why Wait? Join the Movement

📈 Performance

🔮 Future-Ready

🛠️ Developer Experience

🎭 Flexibility

Performance Benchmark

Scenario: Building the test project

macos-latest

ubuntu-latest

windows-latest

Scenario: Tests focused on assertion performance and validation

macos-latest

ubuntu-latest

windows-latest

Scenario: Tests running asynchronous operations and async/await patterns

macos-latest

ubuntu-latest

windows-latest

Scenario: Simple tests with basic operations and assertions

macos-latest

ubuntu-latest

windows-latest

Scenario: Parameterized tests with multiple test cases using data attributes

macos-latest

ubuntu-latest

windows-latest

Scenario: Tests utilizing class fixtures and shared test context

macos-latest

ubuntu-latest

windows-latest

Scenario: Tests executing in parallel to test framework parallelization

macos-latest

ubuntu-latest

windows-latest

Scenario: A test that takes 50ms to execute, repeated 100 times

macos-latest

ubuntu-latest

windows-latest

Scenario: Tests with setup and teardown lifecycle methods

macos-latest

ubuntu-latest

windows-latest