Cosmos.EventDriven.Testing.Utilities 0.0.1-RC.4

Cosmos.EventDriven.Testing.Utilities

Utilidades para pruebas unitarias de Event Driven para .NET 10.

Descripción

Este paquete provee clases abstractas e implementaciones in-memory para facilitar la creación de pruebas unitarias en arquitecturas Event-Driven. Permite verificar que los eventos privados y públicos correctos son publicados durante la ejecución de un handler, sin depender de infraestructura real (mensajería, buses de eventos).

Instalación

dotnet add package Cosmos.EventDriven.Testing.Utilities

Clases disponibles

EventDrivenAsyncTest

Clase base abstracta para pruebas de handlers que publican eventos privados y/o públicos. Expone dos senders in-memory y métodos de aserción:

TestPrivateEventSender

Implementación in-memory de IPrivateEventSender. Acumula los eventos recibidos en Events para ser inspeccionados en las aserciones.

TestPublicEventSender

Implementación in-memory de IPublicEventSender. Acumula los eventos recibidos en Events para ser inspeccionados en las aserciones.

Ejemplo de uso

public class ProcesarPedidoTest : EventDrivenAsyncTest
{
    private readonly ProcesarPedidoHandler _handler;

    public ProcesarPedidoTest()
    {
        _handler = new ProcesarPedidoHandler(PrivateEventSender, PublicEventSender);
    }

    [Fact]
    public async Task Si_ProcesoPedido_Debe_PublicarEventos()
    {
        // Given
        var comando = new ProcesarPedido(Guid.NewGuid());

        // When
        await _handler.HandleAsync(comando);

        // Then
        ThenIsPublishedPrivately(new PedidoRecibido(comando.PedidoId));
        ThenIsPublishedPublicly(new PedidoConfirmado(comando.PedidoId));
    }
}

Notas adicionales

• Los senders son in-memory, ideales para pruebas unitarias rápidas y aisladas.
• ThenIsPublishedPrivately y ThenIsPublishedPublicly validan tanto la cantidad como el tipo y contenido de cada evento.
• Los eventos sin propiedades (vacíos) pasan la validación si el tipo coincide.

Requisitos

• .NET 10.0 o superior

Dependencias

• AwesomeAssertions (v9.4.0) - Librería de assertions fluidas
• xUnit (v3.2.2) - Framework de testing
• Cosmos.EventDriven.Abstractions - Abstracciones de Event Driven

Paquetes Relacionados

• Cosmos.EventDriven.Abstractions: Define las interfaces IPrivateEventSender e IPublicEventSender
• Cosmos.EventDriven.CritterStack: Implementación de producción con Wolverine
• Cosmos.EventSourcing.Testing.Utilities: Utilidades para pruebas de Event Sourcing

Licencia

Copyright © Cosmos. Todos los derechos reservados.