NotoriousTest.TestContainers 4.0.0-beta.112

Clean, isolated, and maintainable integration testing for .NET

If you plan to use this NuGet package, let me know in the Tell me if you use that package ! discussion on Github ! Gaining insight into its usage is very important to me!

Summary

• Purpose
• Hello World
  • Setup
  • Define a Basic Infrastructure
  • Create a Test Environment
  • Write your first test
  • Running Your First Test
• Multi-Framework Support
• Resources & Community
  • Documentation
  • Changelog
  • Contact
• Other packages i'm working on

Purpose

Have you ever had to write and rewrite boilerplate code to set up a database, reset data between each test, or tear down containers? All that setup required to keep your integration tests fully isolated, and ensure their maintainability, reproducibility, and efficiency.

NotoriousTest removes the need to build all of that yourself.

The concept is simple:

1. Create an infrastructure and implement its initialization, reset, and destruction logic.
2. Add it to an environment.
3. Access it directly from your integration tests.

NotoriousTest will automatically manage the lifecycle of your infrastructures. Even after the tests have crashed unexpectedly, thanks to the DoggyDog 🐶.

Hello World

Setup

First, install NuGet. Then, install the package matching your test framework:

PM> Install-Package NotoriousTest.XUnit

Or from the .NET CLI:

dotnet add package NotoriousTest.XUnit

Note: .NET 8 or higher is required.

Define a Basic Infrastructure

An infrastructure represents an external dependency (database, message bus, etc.).

For now, we'll define an empty infrastructure to illustrate the setup. You can replace MyInfrastructure with any real infrastructure later.

public class MyInfrastructure : Infrastructure
{
    public override Task Initialize()
    {
        // Setup logic here (e.g., start a database, configure an API)
        Console.WriteLine($"Setup of {nameof(MyInfrastructure)}");
        return Task.CompletedTask;
    }

    public override Task Reset()
    {
        // Reset logic here (e.g., clear data, reset state)
        Console.WriteLine($"Reset of {nameof(MyInfrastructure)}");
        return Task.CompletedTask;
    }

    public override Task Destroy()
    {
        // Cleanup logic here (e.g., shut down services)
        Console.WriteLine($"Shutdown of {nameof(MyInfrastructure)}");
        return Task.CompletedTask;
    }
}

📌 What this does:

• Defines a basic infrastructure with lifecycle methods.
• This is where you would add setup logic for databases, APIs, queues, etc.

Create a Test Environment

A test environment groups infrastructures together. Extend the environment class from your framework-specific package:

// xUnit
using System.Reflection;
using Xunit.Sdk;

public class MyTestEnvironment : NotoriousTest.XUnit.Environment
{
    public MyTestEnvironment(IMessageSink sink) : base(sink) { }

    public override Assembly CurrentAssembly => Assembly.GetExecutingAssembly();

    public override async Task ConfigureEnvironment()
    {
        AddInfrastructure<MyInfrastructure>();
    }
}

📌 What this does:

• Registers MyInfrastructure inside the test environment.
• Ensures all tests run in a clean and isolated setup.

See Multi-Framework Support for NUnit, MSTest, and TUnit equivalents.

Write your first test

Now, let's write a basic integration test using our environment.

// xUnit
public class MyIntegrationTests : NotoriousTest.XUnit.IntegrationTest<MyTestEnvironment>
{
    public MyIntegrationTests(MyTestEnvironment environment) : base(environment) { }

    [Fact]
    public async Task ExampleTest()
    {
        // Retrieve the infrastructure
        var infra = CurrentEnvironment.GetInfrastructure<MyInfrastructure>();

        // Add test logic here (e.g., verify database state, call an API)

        Assert.NotNull(infra); // Basic validation to confirm setup works
    }
}

📌 What this does:

• Retrieves the test infrastructure from the environment.
• You can add real test logic (API calls, database assertions, etc.).

🚀 Running Your First Test

Now, let's run the test:

dotnet test

Expected Output

You should see something like:

Passed! 1 test successful.

If everything works, congrats! 🎉 You've successfully set up NotoriousTest.

Multi-Framework Support

NotoriousTest supports xUnit, NUnit, MSTest, and TUnit. The environment and test base classes differ per framework — everything else is identical.

NUnit

// Environment
public class MyTestEnvironment : NotoriousTest.NUnit.Environment
{
    public override Assembly CurrentAssembly => Assembly.GetExecutingAssembly();

    public override async Task ConfigureEnvironment()
    {
        AddInfrastructure<MyInfrastructure>();
    }
}

// Tests
[TestFixture]
public class MyIntegrationTests : NotoriousTest.NUnit.IntegrationTest<MyTestEnvironment>
{
    [Test]
    public async Task ExampleTest()
    {
        var infra = CurrentEnvironment.GetInfrastructure<MyInfrastructure>();
        Assert.That(infra, Is.Not.Null);
    }
}

MSTest

// Environment
public class MyTestEnvironment : NotoriousTest.MSTest.Environment
{
    public override Assembly CurrentAssembly => Assembly.GetExecutingAssembly();

    public override async Task ConfigureEnvironment()
    {
        AddInfrastructure<MyInfrastructure>();
    }
}

// Tests
[TestClass]
public class MyIntegrationTests : NotoriousTest.MSTest.IntegrationTest<MyTestEnvironment>
{
    [TestMethod]
    public async Task ExampleTest()
    {
        var infra = CurrentEnvironment.GetInfrastructure<MyInfrastructure>();
        Assert.IsNotNull(infra);
    }
}

TUnit

// Environment
public class MyTestEnvironment : NotoriousTest.TUnit.Environment
{
    public override Assembly CurrentAssembly => Assembly.GetExecutingAssembly();

    public override async Task ConfigureEnvironment()
    {
        AddInfrastructure<MyInfrastructure>();
    }
}

// Tests
public class MyIntegrationTests : NotoriousTest.TUnit.IntegrationTest<MyTestEnvironment>
{
    public MyIntegrationTests(MyTestEnvironment environment) : base(environment) { }

    [Test]
    public async Task ExampleTest()
    {
        var infra = CurrentEnvironment.GetInfrastructure<MyInfrastructure>();
        await Assert.That(infra).IsNotNull();
    }
}

Resources & Community

Documentation

• 📖 Core Concepts – Learn how infrastructures and environments work.
• 🔌 Integrations – See how to integrate SQL Server, TestContainers, and more.
• 📚 Examples – Hands-on use cases with real-world setups.
• 🏛️ Architecture Guidelines – Best practices for structuring your test setup.

Changelog

You can find the changelog here.

Contact

Have questions, ideas, or feedback about NotoriousTest? Feel free to reach out! I'd love to hear from you. Here's how you can get in touch:

• GitHub Issues: Open an issue to report a problem, request a feature, or share an idea.
• Email: briceschumacher21@gmail.com
• LinkedIn : Brice SCHUMACHER

The discussions tabs is now opened ! Feel free to tell me if you use the package here : https://github.com/Notorious-Coding/Notorious-Test/discussions/1 !

Other nugets i'm working on

• NotoriousClient : Notorious Client is meant to simplify the sending of HTTP requests through a fluent builder and an infinitely extensible client system.
• NotoriousModules : Notorious Modules provide a simple way to separate monolith into standalone modules.