LiteBus.Messaging
2.1.0
dotnet add package LiteBus.Messaging --version 2.1.0
NuGet\Install-Package LiteBus.Messaging -Version 2.1.0
<PackageReference Include="LiteBus.Messaging" Version="2.1.0" />
<PackageVersion Include="LiteBus.Messaging" Version="2.1.0" />
<PackageReference Include="LiteBus.Messaging" />
paket add LiteBus.Messaging --version 2.1.0
#r "nuget: LiteBus.Messaging, 2.1.0"
#addin nuget:?package=LiteBus.Messaging&version=2.1.0
#tool nuget:?package=LiteBus.Messaging&version=2.1.0
<h1 align="center"><br> <a href="https://github.com/litenova/LiteBus"> <img src="assets/logo/icon.png"> </a> <br> LiteBus <br> </h1> <h4 align="center">A lightweight, flexible in-process mediator for implementing Command Query Separation (CQS)</h4> <p align="center"> <a href="https://github.com/litenova/LiteBus/actions/workflows/release.yml"> <img src="https://github.com/litenova/LiteBus/actions/workflows/release.yml/badge.svg" alt="CI/CD Badge" /> </a> <a href="https://codecov.io/gh/litenova/LiteBus" > <img src="https://codecov.io/gh/litenova/LiteBus/graph/badge.svg?token=XBNYITSV5A" alt="Code Coverage Badge" /> </a> <a href="https://www.nuget.org/packages/LiteBus"> <img src="https://img.shields.io/nuget/vpre/LiteBus.svg" alt="LiteBus Nuget Version" /> </a> </p> <p align="center"> For detailed documentation and examples, please visit the <a href="https://github.com/litenova/LiteBus/wiki"><b>Wiki</b></a>. </p>
Key Features
Built for .NET 8 and .NET 9 - Multi-targeting support for maximum compatibility
Zero external dependencies - Completely standalone with no third-party dependencies
Reduced reflection usage - Optimized for performance with minimal reflection
DDD-friendly design - Support for plain domain events without library dependencies, keeping your domain model clean
Comprehensive messaging types:
ICommand
/ICommand<TResult>
- For state-changing operationsIQuery<TResult>
- For data retrieval operationsIStreamQuery<TResult>
- For streaming large datasets viaIAsyncEnumerable<T>
IEvent
- For notifications and event-driven architecture- Support for POCO objects as messages without library interfaces
Rich handler ecosystem:
- Pre-handlers for validation and pre-processing
- Post-handlers for notifications and side effects
- Error handlers for centralized exception management
- Support for generic handlers and messages
- Handler ordering control
- Contextual handler selection via tags and filters
Advanced features:
- Covariant type handling for polymorphic dispatch
- Execution context for cross-cutting concerns
- Aborting execution flow when needed
- Microsoft Dependency Injection integration
Quick Example
// Define the command result
public record CreateProductCommandResult(Guid Id);
// Define a command with a result
public record CreateProductCommand(string Title) : ICommand<CreateProductCommandResult>;
// Implement a command validator
public class CreateProductCommandValidator : ICommandValidator<CreateProductCommand>
{
public Task ValidateAsync(CreateProductCommand command, CancellationToken cancellationToken = default)
{
if (string.IsNullOrWhiteSpace(command.Title))
throw new ValidationException("Product title cannot be empty");
return Task.CompletedTask;
}
}
// Implement a command handler
public class CreateProductCommandHandler : ICommandHandler<CreateProductCommand, CreateProductCommandResult>
{
private readonly IProductRepository _repository;
public CreateProductCommandHandler(IProductRepository repository)
{
_repository = repository;
}
public async Task<CreateProductCommandResult> HandleAsync(CreateProductCommand command, CancellationToken cancellationToken = default)
{
var product = new Product(Guid.NewGuid(), command.Title);
await _repository.SaveAsync(product, cancellationToken);
return new CreateProductCommandResult(product.Id);
}
}
// Configure in ASP.NET Core
services.AddLiteBus(liteBus =>
{
liteBus.AddCommandModule(module =>
{
module.RegisterFromAssembly(typeof(CreateProductCommand).Assembly);
});
});
// Use in a controller or service
public class ProductsController : ControllerBase
{
private readonly ICommandMediator _commandMediator;
public ProductsController(ICommandMediator commandMediator)
{
_commandMediator = commandMediator;
}
[HttpPost]
public async Task<ActionResult<CreateProductCommandResult>> CreateProduct(CreateProductCommand command)
{
var result = await _commandMediator.SendAsync(command);
return Ok(result);
}
}
Documentation
For comprehensive documentation, including detailed explanations, advanced features, and best practices, please visit the Wiki.
Installation
LiteBus is available as NuGet packages:
dotnet add package LiteBus
dotnet add package LiteBus.Extensions.MicrosoftDependencyInjection
Or specific modules:
dotnet add package LiteBus.Commands
dotnet add package LiteBus.Queries
dotnet add package LiteBus.Events
License
LiteBus is licensed under the MIT License. See the LICENSE file for details.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net8.0
- LiteBus.Messaging.Abstractions (>= 2.1.0)
-
net9.0
- LiteBus.Messaging.Abstractions (>= 2.1.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on LiteBus.Messaging:
Package | Downloads |
---|---|
LiteBus.Messaging.Extensions.MicrosoftDependencyInjection
LiteBus is a lightweight, flexible in-process mediator for implementing Command Query Separation (CQS) patterns in .NET applications. |
|
LiteBus
LiteBus is a lightweight, flexible in-process mediator for implementing Command Query Separation (CQS) patterns in .NET applications. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last Updated |
---|---|---|
2.1.0 | 168 | 7/1/2025 |
2.0.0 | 1,249 | 4/29/2025 |
1.1.0 | 206 | 4/24/2025 |
1.0.0 | 131 | 4/19/2025 |
0.25.1 | 233 | 4/17/2025 |
0.25.0 | 206 | 4/13/2025 |
0.24.4 | 199 | 4/10/2025 |
0.24.3 | 2,637 | 5/2/2024 |
0.24.2 | 223 | 4/16/2024 |
0.24.1 | 179 | 1/30/2024 |
0.23.1 | 1,716 | 1/11/2024 |
0.23.0 | 255 | 12/23/2023 |
0.22.0 | 221 | 12/23/2023 |
0.21.0 | 212 | 12/18/2023 |
0.20.2 | 223 | 12/8/2023 |
0.20.1 | 202 | 12/5/2023 |
0.20.0 | 953 | 12/5/2023 |
0.19.1 | 190 | 11/25/2023 |
0.19.0 | 187 | 11/23/2023 |
0.18.4 | 240 | 11/23/2023 |
0.18.3 | 240 | 11/23/2023 |
0.18.2 | 231 | 11/22/2023 |
0.18.1 | 679 | 11/6/2023 |
0.18.0 | 260 | 11/1/2023 |
0.17.1 | 197 | 10/20/2023 |
0.16.0 | 259 | 9/26/2023 |
0.15.1 | 2,320 | 6/23/2023 |
0.15.0 | 284 | 6/23/2023 |
0.14.1 | 271 | 6/22/2023 |
0.14.0 | 582 | 11/30/2022 |
0.13.0 | 1,115 | 10/7/2022 |
0.12.0 | 4,583 | 1/6/2022 |
0.11.3 | 4,170 | 12/27/2021 |
0.11.2 | 704 | 12/27/2021 |
0.11.1 | 664 | 12/26/2021 |
0.11.0 | 695 | 12/23/2021 |
0.10.2 | 665 | 12/22/2021 |
0.10.1 | 670 | 12/20/2021 |
0.10.0 | 773 | 12/15/2021 |
0.9.1 | 1,271 | 10/25/2021 |
0.9.0 | 926 | 10/25/2021 |
0.8.1 | 3,358 | 10/9/2021 |
0.8.0 | 2,032 | 9/7/2021 |
0.7.0 | 1,134 | 8/19/2021 |
0.6.3 | 1,312 | 8/9/2021 |
0.6.2 | 928 | 8/9/2021 |
0.6.1 | 895 | 8/9/2021 |
0.6.0 | 943 | 8/9/2021 |
0.5.0 | 689 | 7/8/2021 |
0.4.0 | 961 | 4/13/2021 |
0.3.1 | 626 | 4/13/2021 |
0.2.1 | 643 | 4/9/2021 |
0.2.0 | 620 | 4/6/2021 |
0.1.0 | 768 | 3/17/2021 |