Axent.Core 1.0.0

Axent

Axent is a lightweight, high-performance .NET library for implementing CQRS patterns with minimal boilerplate. It provides a simple request/response pipeline and allows adding custom processors for advanced scenarios.

Features

• Minimal setup for CQRS in .NET applications
• Request/response handling with RequestHandler<TRequest, TResponse>
• Extensible pipelines using IAxentPipe<TRequest, TResponse>
• Optimized for performance and simplicity
• Works seamlessly with ASP.NET Core

Prerequisites

• .NET 8 or later

Getting started

1. Install Packages

dotnet add package Axent.Core --version 0.0.1
dotnet add package Axent.Extensions.AspNetCore --version 0.0.1

2. Register Services

builder.Services.AddHttpContextAccessor()
builder.Services.AddAxent()
    .AddRequestHandlers(AssemblyProvider.Current);

3. Implement a Request Handler

Example showing a request that logs a message

using Axent.Abstractions;
using Axent.Core;

namespace Axent.ExampleApi;

internal sealed class ExampleRequest : IRequest<Unit>
{
    public required string Message { get; init; }
}

internal sealed class ExampleRequestHandler : RequestHandler<ExampleRequest, Unit>
{
    private readonly ILogger<ExampleRequestHandler> _logger;

    public ExampleRequestHandler(ILogger<ExampleRequestHandler> logger)
    {
        _logger = logger;
    }

    public override Task<Response<Unit>> HandleAsync(RequestContext<ExampleRequest> context, CancellationToken cancellationToken = default)
    {
        _logger.LogInformation("Message from request '{0}'", context.Request.Message);
        return Task.FromResult(Response<Unit>.Success(Unit.Value));
    }
}

4. Call the Request Handler in an API Endpoint

app.MapGet("/api/example", async (ISender sender, CancellationToken cancellationToken) =>
{
    var request = new ExampleRequest
    {
        Message = "Hello World!"
    };

    var response = await sender.SendAsync(request, cancellationToken);
    return response.ToResult();
});

Pipelines

Axent allows you to add custom processors to your request pipeline by implementing IAxentPipe<TRequest, TResponse>. This is useful for logging, validation, metrics, or any cross-cutting concerns.

Example Pipe

internal sealed class ExampleRequestPipe<TRequest, TResponse> : IAxentPipe<TRequest, TResponse>
{
    private readonly ILogger<ExampleRequestPipe<TRequest, TResponse>> _logger;

    public ExampleRequestPipe(ILogger<ExampleRequestPipe<TRequest, TResponse>> logger)
    {
        _logger = logger;
    }
    
    public ValueTask<Response<TResponse>> ProcessAsync(Func<ValueTask<Response<TResponse>>> next, RequestContext<TRequest> context, CancellationToken cancellationToken = default)
    {
        _logger.LogInformation("This pipe runs during every request.");
        return next();
    }
}

This pipe executes for every request handled by Axent.

Contributing

Contributions are welcome! Please open an issue or pull request for bug fixes, improvements, or new features.

License

This project is licensed under the Apache License.