👁 Image
AutoFixture.NUnit4 4.19.0

AutoFixture.NUnit4

👁 License
👁 NuGet version
👁 NuGet preview version
👁 NuGet downloads

AutoFixture.NUnit4 is a .NET library that integrates AutoFixture with NUnit 4.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.

Table of Contents

• Installation
• Getting Started
• Integrations
• License

Installation

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.

dotnet add package AutoFixture.NUnit4 --version x.x.x

<PackageReference Include="AutoFixture.NUnit4" Version="x.x.x" />

Getting Started

Basic Usage

AutoFixture.NUnit4 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.NUnit4;

[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.That(result, Is.EqualTo(a + b));
 }
}

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.NUnit4;
using AutoFixture;

[TestFixture]
public class ConsumerTests
{
 [Test, AutoData]
 public void Consumer_UsesSameDependency(
 [Frozen] Dependency dependency, Consumer consumer)
 {
 // Assert
 Assert.That(dependency, Is.SameAs(consumer.Dependency));
 }
}

Integrations

AutoFixture offers a variety of utility packages and integrations with most of the major mocking libraries and testing frameworks.

Core packages

The core packages offer the full set of AutoFixture's features without requring any testing framework or third party integration.

Mocking libraries

AutoFixture offers integations with most major .NET mocking libraries.<br/> These integrations enable such features as configuring mocks, auto-injecting mocks, etc.

Testing frameworks

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 are welcome!<br/> 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.

.NET Foundation

This project is supported by the .NET Foundation.