FluentMediator

KO | EN

gitlite — search

#ai #python #ai-agents #react #rust #mcp #claude-code #developer-tools #automation #devops #go #typescript

★ 196 Open GitHub ↗

:twisted_rightwards_arrows: FluentMediator is an unobtrusive library that allows developers to build custom pipelines for Commands, Queries and Events.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FluentMediator
[![Build Status](https://ivanpaulovich.visualstudio.com/FluentMediator/_apis/build/status/ivanpaulovich.FluentMediator?branchName=master)](https://ivanpaulovich.visualstudio.com/FluentMediator/_build/latest?definitionId=24&branchName=master) [![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg?style=flat-square)](https://raw.githubusercontent.com/ivanpaulovich/FluentMediator/master/) ![GitHub issues](https://img.shields.io/github/issues/ivanpaulovich/FluentMediator) ![GitHub pull requests](https://img.shields.io/github/issues-pr/ivanpaulovich/FluentMediator) <a href="https://www.nuget.org/packages/FluentMediator/" rel="Paulovich.Caju">![NuGet](https://buildstats.info/nuget/FluentMediator)</a>

:twisted_rightwards_arrows: We will not require you to add dependencies into your domain or to implement frameworks interfaces in your event handlers. Finally a really loosely coupled mediator library was born.

## Install

```
Install-Package FluentMediator
```

For seameless .NET Core integration:

```
Install-Package FluentMediator.Microsoft.Extensions.DependencyInjection
```

## How

Setup your events and pipelines using depedency injection. You can be very creative here! It supports async methods and cancellable tokens parameters, you could append multiple steps select one to return a message. An example:

```c#
services.AddFluentMediator(builder => {
 builder.On<PingRequest>().Pipeline()
 .Call<IPingHandler>((handler, request) => handler.MyMethod(request))
 .Call<IPingHandler>((handler, request) => handler.MyLongMethod(request))
 .Return<PingResponse, IPingHandler>(
 (handler, request) => handler.MyOtherMethod(request)
 );
});
```

Then you are able to use the injected `IMediator` interface.

### Publishing Events

```c#
// Puts the message in the pipeline, calls three handlers.
mediator.Publish<PingRequest>(ping);
```

### Sending Commands and Queries

```c#
// Calls the three handlers then get the response from `MyOtherMethod(PingRequest)`.
PingResponse response = mediator.Send<PingResponse>(new PingRequest("Ping"));
Console.WriteLine(response.Message); // Prints "Pong"
```

## Why

When designing *CQRS* or *Event-Driven* applications we need to publish events from the infrastructure layer into the *domain event handlers*. We do not want framework dependencies leaking out to the Model then **FluentMediator** was born.

## Contributors

<table>
 <tr>
 <td align="center"><a href="https://paulovich.net"><img src="https://avatars3.githubusercontent.com/u/7133698?v=4" width="100px;" alt="Ivan Paulovich"/> Ivan Paulovich</a> <a href="https://github.com/ivanpaulovich/FluentMediator/commits?author=ivanpaulovich" title="Code">💻</a> <a href="#design-ivanpaulovich" title="Design">🎨</a> <a href="https://github.com/ivanpaulovich/FluentMediator/commits?author=ivanpaulovich" title="Tests">⚠️</a></td>
 <td align="center"><a href="http://www.carselind.se"><img src="https://avatars1.githubusercontent.com/u/439028?v=4" width="100px;" alt="Joakim Carselind"/> Joakim Carselind</a> <a href="#review-joacar" title="Reviewed Pull Requests">👀</a> <a href="#ideas-joacar" title="Ideas, Planning, & Feedback">🤔</a></td>
 <td align="center"><a href="https://github.com/vag1830"><img src="https://avatars2.githubusercontent.com/u/1694870?v=4" width="100px;" alt="Vaggelis Mparmpas"/> Vaggelis Mparmpas</a> <a href="https://github.com/ivanpaulovich/FluentMediator/commits?author=vag1830" title="Tests">⚠️</a></td>
 </tr>
</table>

Please contribute with [Issues](https://github.com/ivanpaulovich/FluentMediator/issues), [Wiki](https://github.com/ivanpaulovich/FluentMediator/wiki) and [Samples](https://github.com/ivanpaulovich/FluentMediator/tree/master/samples).

FluentMediator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README