NextUnit 1.13.0

NextUnit - Modern Testing for .NET 10+

NextUnit is a modern, high-performance test framework for .NET 10+ that combines:

• TUnit's modern architecture - Microsoft.Testing.Platform, Native AOT, source generators
• xUnit's familiar assertions - Classic Assert.Equal(expected, actual), no fluent syntax

Quick Start

Installation

Simple - One Package (Recommended):

dotnet add package NextUnit

This meta-package includes everything you need:

• NextUnit.Core - Attributes, assertions, execution engine
• NextUnit.Generator - Source generator for zero-reflection discovery
• NextUnit.TestAdapter - VSTest adapter for Visual Studio Test Explorer
• Microsoft.NET.Test.Sdk - Test platform SDK

Configure Your Test Project

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="NextUnit" Version="1.13.0" />
  </ItemGroup>
</Project>

Note: No OutputType=Exe or Program.cs needed - NextUnit works as a class library with VSTest adapter.

Write Your First Test

using NextUnit;

public class CalculatorTests
{
    [Test]
    public void Add_TwoNumbers_ReturnsSum()
    {
        var result = 2 + 2;
        Assert.Equal(4, result);
    }

    [Test]
    [Arguments(1, 2, 3)]
    [Arguments(5, 5, 10)]
    public void Add_Parameterized(int a, int b, int expected)
    {
        Assert.Equal(expected, a + b);
    }
}

Run Tests

dotnet test

Key Features

• Zero-reflection execution - Fast test discovery via source generators
• Rich assertions - Collections, strings, numerics with great error messages
• Test artifacts - Attach screenshots, logs, videos to test results
• Combined data sources - [Values], [ValuesFromMember], [ValuesFrom<T>] with Cartesian product
• Matrix data source - [Matrix] for Cartesian product test generation
• Class data source - [ClassDataSource<T>] with shared instance support
• Explicit tests - [Explicit] to exclude from default runs
• Roslyn analyzers - Compile-time validation of test code
• Multi-scope lifecycle - Test, Class, Assembly scopes
• Parallel control - [ParallelLimit], [NotInParallel("key")], [ParallelGroup("name")]
• Test dependencies - [DependsOn] with ProceedOnFailure option
• Native AOT compatible - Full trim and AOT support

Packages

Total Size: 72.4 KB (ultra-lightweight!)

Documentation

• Getting Started Guide
• Migration from xUnit
• Best Practices
• Full Documentation

What's Different from xUnit?

Contributing

Contributions welcome! See our Contributing Guide.

License

MIT License

Acknowledgments

Inspired by:

• TUnit - Modern architecture, source generators
• xUnit - Ergonomic assertions, proven patterns
• NUnit/MSTest - Battle-tested reliability

Built with love for .NET 10+ developers who want modern performance with familiar syntax.