By leveraging the some features of NUnit, this extension turns AutoFixture into a declarative framework for writing unit tests. In many ways it becomes a unit testing DSL (Domain Specific Language).
AutoFixture.NUnit2 is a .NET library that integrates AutoFixture with NUnit 2.x, allowing you to effortlessly generate test data for your unit tests.
By automatically populating your test parameters, it helps you write cleaner, more maintainable tests without having to manually construct test objects.
[!WARNING]
While this package is still being developed, the NUnit 2 package is deprecated.<br/>
This package is intended for legacy projects that are still using NUnit 2.x.<br/>
Use at your own risk.
AutoFixture packages are distributed via NuGet.<br />
To install the packages you can use the integrated package manager of your IDE, the .NET CLI, or reference the package directly in your project file.
AutoFixture.NUnit2 provides an [AutoData] attribute that automatically populates test method parameters with generated data.
For example, imagine you have a simple calculator class:
public class Calculator
{
public int Add(int a, int b) => a + b;
}
You can write a test using AutoFixture to provide the input values:
using NUnit.Framework;
using AutoFixture.NUnit2;
[TestFixture]
public class CalculatorTests
{
[Test, AutoData]
public void Add_SimpleValues_ReturnsCorrectResult(
Calculator calculator, int a, int b)
{
// Act
int result = calculator.Add(a, b);
// Assert
Assert.AreEqual(a + b, result);
}
}
Freezing Dependencies
AutoFixture's [Frozen] attribute can be used to ensure that the same instance of a dependency is injected into multiple parameters.
For example, if you have a consumer class that depends on a shared dependency:
public class Dependency { }
public class Consumer
{
public Dependency Dependency { get; }
public Consumer(Dependency dependency)
{
Dependency = dependency;
}
}
You can freeze the Dependency so that all requests for it within the test will return the same instance:
using NUnit.Framework;
using AutoFixture.NUnit2;
using AutoFixture;
[TestFixture]
public class ConsumerTests
{
[Test, AutoData]
public void Consumer_UsesSameDependency(
[Frozen] Dependency dependency, Consumer consumer)
{
// Assert
Assert.AreSame(dependency, consumer.Dependency);
}
}
Integrations
AutoFixture offers a variety of utility packages and integrations with most of the major mocking libraries and testing frameworks.
[!NOTE]
Since AutoFixture tries maintain compatibility with a large number of package versions, the packages bundled with AutoFixture might not contain the latest features of your (e.g. mocking) library.<br />
Make sure to install the latest version of the integrated library package, alongside the AutoFixture packages.
Core packages
The core packages offer the full set of AutoFixture's features without requring any testing framework or third party integration.
AutoFixture offers integations with most major .NET mocking libraries.<br/>
These integrations enable such features as configuring mocks, auto-injecting mocks, etc.
AutoFixture offers integrations with most major .NET testing frameworks.<br />
These integrations enable auto-generation of test cases, combining auto-generated data with inline arguments, etc.
You can check the compatibility with your target framework version on the wiki or on the NuGet website.
Contributing
Contributions to AutoFixture.NUnit2 are welcome!
If you would like to contribute, please review our contributing guidelines and open an issue or pull request.
License
AutoFixture is Open Source software and is released under the MIT license.<br />
The licenses allows the use of AutoFixture libraries in free and commercial applications and libraries without restrictions.
