Handly 1.0.2

Handly

Handly is a lightweight and transparent mediator-style dispatcher for .NET. Inspired by MediatR, it aims to be faster, leaner, and open-source.

🚀 Benchmarks

Performed on a MacBook M1 Pro (.NET 9, BenchmarkDotNet, Release build)

✅ Why Handly?

• Open-source and Free — no license cost, forever.
• Transparent and Hackable — know what runs and why.
• Performant — especially with no behaviors.
• No Reflection at Runtime — compiled, cached, and minimal allocations.

✨ Features

• Lightweight Dispatcher for IRequest<TResponse>
• Pipeline behaviors (logging, validation, metrics...)
• Assembly scanning for handler auto-registration
• Plug-and-play DI integration
• Dead simple API and structure

📦 Installation

dotnet add package Handly

Or via NuGet:

https://www.nuget.org/packages/Handly

👋 Getting Started

1. Define a Request

public class Ping : IRequest<string> { }

2. Create a Handler

public class PingHandler : IRequestHandler<Ping, string>
{
    public Task<string> Handle(Ping request, CancellationToken cancellationToken)
    {
        return Task.FromResult("Pong");
    }
}

3. (Optional) Add a Behavior

public class LoggingBehavior<TRequest, TResponse> : IPipelineBehavior<TRequest, TResponse>
    where TRequest : IRequest<TResponse>
{
    private readonly ILogger<LoggingBehavior<TRequest, TResponse>> _logger;

    public LoggingBehavior(ILogger<LoggingBehavior<TRequest, TResponse>> logger)
    {
        _logger = logger;
    }

    public async Task<TResponse> Handle(
        TRequest request,
        RequestHandlerDelegate<TRequest, TResponse> next,
        CancellationToken cancellationToken)
    {
        _logger.LogInformation($"Handling {typeof(TRequest).Name}");
        var response = await next();
        _logger.LogInformation($"Handled {typeof(TRequest).Name}");
        return response;
    }
}

4. Register with DI

builder.Services.AddHandly(cfg =>
{
    cfg.RegisterHandlerFromAssembly(Assembly.GetExecutingAssembly());
    cfg.AddBehavior(typeof(IPipelineBehavior<,>), typeof(LoggingBehavior<,>));
});

5. Dispatch a request

public class MyService
{
    private readonly IDispatcher _dispatcher;

    public MyService(IDispatcher dispatcher)
    {
        _dispatcher = dispatcher;
    }

    public async Task ExecuteAsync()
    {
        var request = new Ping();
        var response = await _dispatcher.Dispatch(request);
        Console.WriteLine(response); // Pong
    }
}

❤️ Contributing

Pull requests are welcome! For major changes, please open an issue first.

🔒 License

MIT. Free as in freedom.

Made with ❤️ by developer who like things fast and clean.