EasyChain 1.0.5-g5a6d0b3b32

EasyChain

EasyChain is a lightweight .NET library designed for implementing the Chain of Responsibility pattern. It enables you to define a sequence of handlers to process messages in a flexible and decoupled manner.

<p align="left"> <a href="https://github.com/cleberMargarida/easy-chain/actions/workflows/workflow.yml"> <img src="https://github.com/cleberMargarida/easy-chain/actions/workflows/workflow.yml/badge.svg" alt="Build-deploy pipeline"> </a> <a href="https://www.nuget.org/packages/EasyChain"> <img src="https://img.shields.io/nuget/vpre/EasyChain.svg" alt="EasyChain Nuget Version"> </a>
<a href="https://github.com/cleberMargarida/easy-chain/actions/runs/10553862586#summary-29234823720"> <img src="https://camo.githubusercontent.com/ff5d6927f201cb1122f1a454a524c334a4406398af1ce88c5ac4c5fd57501ae9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6465253230436f7665726167652d3130302532352d737563636573733f7374796c653d666c6174" alt="EasyChain Coverage"> </a> </p>

Chain of responsibility

A light-weight and straightforward library for implementing the chain of responsibility pattern. Consider take a look at Source Making - Chain of Responsibility

flowchart LR
    A[Chain Run] -->|message| C{Decision 1}
    C -->|Yes| D[await next]
    C -->|No| P[Return]
    D --> F{Decision 2}
    F -->|Yes| H[await next]
    F -->|No| Q[Return]
    H --> I{Decision 3}
    I -->|Yes| J[await next]
    I -->|No| R[Return]

Features

• .NET Standard Support: Compatible with all .NET applications, including .NET Core, .NET 5, .NET 6, .NET 7, .NET 8, and .NET 9.
• Integration with Dependency Injection: Fully supports Microsoft.Extensions.DependencyInjection, including various lifetime options.
• Fluent API: Define and configure chains of handlers using a simple and expressive fluent API.
• Asynchronous Processing: Handles messages asynchronously.
• Runtime Compilation: We make usage System.Linq.Expressions to compile methods dynamically at runtime, ensuring no code is embedded between your handlers.
• Ease of Use: Extremely straightforward to set up and use.

Installation

To install EasyChain, add the following package to your project via NuGet:

dotnet add package EasyChain

Usage

Here's a quick example to get you started:

1. Define Your Chain

class CarChain : IChainBuilder<Car>
{
    public void Configure(IChainConfig<Car> callChain)
    {
        callChain.Add<CarYearHandler>();
        callChain.Add<CarModelHandler>();
    }
}

class CarYearHandler : IHandler<Car>
{
    public async Task Handle(Car message, ChainHandling<Car> next)
    {
        if (message.Year > 1960)
            await next(message);
    }
}

class CarModelHandler : IHandler<Car>
{
    public async Task Handle(Car message, ChainHandling<Car> next)
    {
        if (message.Model == "FooModel")
            await next(message);
    }
}

2. Register the Chain

builder.Services.AddChain<CarChain>();

3. Run the Chain

IChain<Car> chain = app.Services.GetService<IChain<Car>>();

var message = new Car
{
    Model = "FooModel",
    Year = 2024,
};

await chain.Run(message);

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For any questions or support, please reach out to cleber.margarida@outlook.com.