Chatilay.Cqrs 0.1.0-preview.1

Chatilay.Cqrs

Tek bir ICommandQueryRequest soyutlaması üzerine kurulu, reflection maliyeti cache'lenmiş hafif CQRS / mediator altyapısı. ICommand / IQuery ayrımı yoktur.

Kurulum

dotnet add package Chatilay.Cqrs

Kayıt

builder.Services.AddChatilayCqrs(typeof(Program).Assembly);

veya

builder.Services.AddChatilayCqrs(options =>
{
    options.RegisterServicesFromAssemblyContaining<Program>();
    options.HandlerLifetime = ServiceLifetime.Scoped;
    options.SenderLifetime = ServiceLifetime.Scoped;
});

Dönüş değeri olan istek

public sealed record GetUserQuery(int Id) : ICommandQueryRequest<UserDto>;

public sealed class GetUserQueryHandler : ICommandQueryHandler<GetUserQuery, UserDto>
{
    public Task<UserDto> Handle(GetUserQuery request, CancellationToken cancellationToken)
        => Task.FromResult(new UserDto(request.Id));
}

var user = await sender.Send(new GetUserQuery(1), cancellationToken);

Dönüş değeri olmayan istek

public sealed record DeleteUserCommand(int Id) : ICommandQueryRequest;

public sealed class DeleteUserCommandHandler : ICommandQueryHandler<DeleteUserCommand>
{
    public Task HandleAsync(DeleteUserCommand request, CancellationToken cancellationToken)
        => Task.CompletedTask;
}

await sender.Send(new DeleteUserCommand(1), cancellationToken);

Event

public sealed record UserCreatedEvent(int Id) : IEvent;

public sealed class AuditHandler : IEventHandler<UserCreatedEvent>
{
    public Task Handle(UserCreatedEvent @event, CancellationToken cancellationToken)
        => Task.CompletedTask;
}

await sender.Publish(new UserCreatedEvent(1), cancellationToken);

Publish handler'ları runtime tipine göre çözer ve sırayla çalıştırır.

API yüzeyi

Depo yapısı

Chatilay.Cqrs/
├── Directory.Build.props
├── LICENSE
├── README.md
├── artifacts/                     # tüm build çıktısı (UseArtifactsOutput)
├── src/Chatilay.Cqrs/
└── tests/Chatilay.Cqrs.Tests/

Kaynaktan derleme

dotnet test -c Release
dotnet pack -c Release

Çıktı:

artifacts/bin/Chatilay.Cqrs/release/Chatilay.Cqrs.dll
artifacts/package/release/Chatilay.Cqrs.<version>.nupkg

Sürüm çıkarma

Directory.Build.props içindeki <Version> güncellenir, ardından tag push edilir:

git tag v0.1.0-preview.1
git push origin v0.1.0-preview.1

.github/workflows/publish.yml testleri çalıştırır, paketi üretir ve NUGET_API_KEY secret'ı ile nuget.org'a push eder.

Lisans

MIT