AutoMoq

AutoMoq is a library that integrates AutoFixture with Moq, a popular mocking framework for .NET. It simplifies the process of creating mock objects and automatically injects them into your tests, reducing boilerplate code and making your tests cleaner and easier to read.

Installation

dotnet add package AutoMoq

Basic Usage

Create a Sample Service and Interface

public interface ICalculator
{
    int Add(int a, int b);
}

public class MathService
{
    private readonly ICalculator _calculator;

    public MathService(ICalculator calculator)
    {
        _calculator = calculator;
    }

    public int AddNumbers(int a, int b)
    {
        return _calculator.Add(a, b);
    }
}

using AutoFixture;
using AutoFixture.AutoMoq;
using Moq;
using Xunit;

public class MathServiceTests
{
    private readonly IFixture _fixture;

    public MathServiceTests()
    {
        _fixture = new Fixture().Customize(new AutoMoqCustomization()); // Set up AutoMoq
    }

    [Fact]
    public void AddNumbers_ShouldReturnCorrectSum_WhenCalculatorIsMocked()
    {
        // Arrange
        var calculatorMock = _fixture.Freeze<Mock<ICalculator>>(); // Freeze the mock
        calculatorMock.Setup(c => c.Add(2, 3)).Returns(5); // Set up mock behavior

        var mathService = _fixture.Create<MathService>(); // Create the service

        // Act
        var result = mathService.AddNumbers(2, 3);

        // Assert
        result.Should().Be(5);
    }
}

Explanation

Customization: The AutoMoqCustomization tells AutoFixture to create mocks for any interfaces during object creation.
Freezing Mocks: The Freeze<Mock>() method allows you to reuse the same mock instance throughout your test.
Setting Up Mocks: You can set up specific behaviors for the mocked methods, which helps control the test scenarios.
Creating the Service: The Create() method automatically injects the mocked ICalculator into the MathService constructor.