Subatomix.Testing 3.1.0

.NET 6.0 .NET Framework 4.8.1 
dotnet add package Subatomix.Testing --version 3.1.0
NuGet\Install-Package Subatomix.Testing -Version 3.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Subatomix.Testing" Version="3.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Subatomix.Testing --version 3.1.0
#r "nuget: Subatomix.Testing, 3.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Subatomix.Testing as a Cake Addin
#addin nuget:?package=Subatomix.Testing&version=3.1.0

// Install Subatomix.Testing as a Cake Tool
#tool nuget:?package=Subatomix.Testing&version=3.1.0

About

Build Build NuGet NuGet

My preferred frameworks for automated testing in .NET.

See here for a list of included packages and their versions.

This package also includes the TestHarnessBase class, which aids my preferred technique for setup/teardown code. Generally, I eschew traditional SetUp and TearDown methods. Instead, in each test, I create an instance of a disposable context class. Construction is setup, and disposal is teardown. Because TestContext means something else already in NUnit, I call this pattern Test Harness instead.

[Test]
public void TestSomething()
{
    using var h = new TestHarness();

    // rest of test
}

private class TestHarness : TestHarnessBase
{
    // properties for mocks and things

    public TestHarness()
    {
        // setup code
    }

    protected override CleanUp()
    {
        // teardown code
    }
}

This pattern enables some cool things:

  • I can enable the C# 8 nullability checker and not have to sprinkle ? and ! all over the test code.

  • Tests can run in parallel, regardless of test fixture lifetime, since there is no longer any shared state within a test class.

  • Test-support code can be isolated away from the tests themselves.

If the test fixture lifetime is instance-per-test-case, the test fixture itself can be a subclass of TestHarnessBase. This results in a test fixture more closely resembling a traditional one and removes the need for a using statement in each test, while retaining the improved nullability ergonomics. However, directly subclassing TestHarnessBase forfeits the isolation afforded by having a separate test harness class.

[TestFixture]
public class SomeTests : TestHarnessBase
{
    // properties for mocks and things

    public TestHarness()
    {
        // setup code
    }

    protected override CleanUp()
    {
        // teardown code
    }

    [Test]
    public void TestSomething()
    {
        // test
    }
}
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Framework net481 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.1.0 85 3/11/2024
3.1.0-rc.1 43 3/9/2024
3.0.0 168 12/23/2023
3.0.0-rc.1 57 12/23/2023
2.6.0 141 9/24/2023
2.5.1 257 7/21/2023
2.5.1-rc.1 77 7/21/2023
2.5.0 275 6/3/2023
2.5.0-rc.1 74 6/1/2023
2.4.1 361 12/10/2022
2.4.0 311 11/13/2022
2.4.0-rc.2 90 11/12/2022
2.4.0-rc.1 89 11/12/2022
2.3.0 344 10/29/2022
2.3.0-rc.1 88 10/29/2022
2.2.0 499 6/12/2022
2.2.0-rc.1 113 6/12/2022
2.1.0 476 5/22/2022
2.1.0-rc.1 112 5/22/2022
2.0.1 558 5/2/2022
2.0.0 548 4/18/2022
2.0.0-rc.4 119 4/18/2022
2.0.0-rc.3 115 4/17/2022
2.0.0-rc.2 114 2/6/2022
1.1.5 520 9/27/2021
1.1.5-rc.2 138 9/27/2021
1.1.3 494 4/4/2021
1.1.2 476 3/7/2021
1.1.1 465 2/3/2021
1.1.0 485 1/22/2021
1.0.0 554 12/26/2020
1.0.0-rc.2 255 12/18/2020
1.0.0-rc.1 272 11/1/2020

https://github.com/sharpjs/Subatomix.Testing/blob/main/CHANGES.md