MVFC.Pack.Testing 4.0.0

MVFC.Pack.Testing

🇧🇷 Leia em Português · ← Back to MVFC.Pack

Metapackage for unit and integration testing — xUnit v3, NSubstitute, Bogus, AutoBogus, FluentAssertions and Testcontainers, all pinned and ready.

Motivation

Writing tests from the first commit requires the same ecosystem every time: a test framework, a mocking library, a fake-data generator, an assertion library with readable failure messages, and a way to spin up real infrastructure (databases, brokers) without managing Docker Compose files manually.

MVFC.Pack.Testing ships all of them, pinned to compatible versions, so your test project is productive from the moment the package is installed.

Installation

dotnet add package MVFC.Pack.Testing

Quick Start

// 1. Unit test with NSubstitute + FluentAssertions
public class OrderServiceTests
{
    private readonly IOrderRepository _repo = Substitute.For<IOrderRepository>();
    private readonly OrderService _sut;

    public OrderServiceTests() => _sut = new OrderService(_repo);

    [Fact]
    public async Task CreateOrder_ShouldReturnId()
    {
        _repo.SaveAsync(Arg.Any<Order>()).Returns(Guid.NewGuid());

        var result = await _sut.CreateAsync(new CreateOrderRequest("Keyboard", 1));

        result.Should().NotBeEmpty();
        await _repo.Received(1).SaveAsync(Arg.Any<Order>());
    }
}

// 2. Fake data with Bogus
var faker = new Faker<Order>()
    .RuleFor(o => o.Id,      f => f.Random.Guid())
    .RuleFor(o => o.Product, f => f.Commerce.ProductName())
    .RuleFor(o => o.Total,   f => f.Finance.Amount());

var orders = faker.Generate(10);

// 3. AutoBogus — generate fully populated objects automatically
var order = AutoFaker.Generate<Order>();

// 4. Integration test with Testcontainers — real MongoDB, no mocks
public class OrderRepositoryTests : IAsyncLifetime
{
    private readonly MongoDbContainer _mongo = new MongoDbBuilder().Build();

    public Task InitializeAsync() => _mongo.StartAsync();
    public Task DisposeAsync()    => _mongo.DisposeAsync().AsTask();

    [Fact]
    public async Task Insert_ShouldPersistOrder()
    {
        var repo = new OrderRepository(_mongo.GetConnectionString());
        var order = AutoFaker.Generate<Order>();

        await repo.InsertAsync(order);
        var found = await repo.GetByIdAsync(order.Id);

        found.Should().NotBeNull();
        found!.Id.Should().Be(order.Id);
    }
}

Included Packages

License

Apache-2.0