LiteBus.Extensions.MicrosoftDependencyInjection
2.0.0
dotnet add package LiteBus.Extensions.MicrosoftDependencyInjection --version 2.0.0
NuGet\Install-Package LiteBus.Extensions.MicrosoftDependencyInjection -Version 2.0.0
<PackageReference Include="LiteBus.Extensions.MicrosoftDependencyInjection" Version="2.0.0" />
<PackageVersion Include="LiteBus.Extensions.MicrosoftDependencyInjection" Version="2.0.0" />
<PackageReference Include="LiteBus.Extensions.MicrosoftDependencyInjection" />
paket add LiteBus.Extensions.MicrosoftDependencyInjection --version 2.0.0
#r "nuget: LiteBus.Extensions.MicrosoftDependencyInjection, 2.0.0"
#addin nuget:?package=LiteBus.Extensions.MicrosoftDependencyInjection&version=2.0.0
#tool nuget:?package=LiteBus.Extensions.MicrosoftDependencyInjection&version=2.0.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 in .NET 8
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 was computed. 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. |
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2.0.0 | 142 | 5 days ago |
1.1.0 | 146 | 10 days ago |
1.0.0 | 79 | 15 days ago |
0.25.1 | 180 | 17 days ago |
0.25.0 | 164 | 21 days ago |
0.24.4 | 149 | 24 days ago |
0.24.3 | 2,384 | 5/2/2024 |
0.24.2 | 158 | 4/16/2024 |
0.24.1 | 127 | 1/30/2024 |
0.23.1 | 1,631 | 1/11/2024 |
0.23.0 | 167 | 12/23/2023 |
0.22.0 | 144 | 12/23/2023 |
0.21.0 | 122 | 12/18/2023 |
0.20.2 | 135 | 12/8/2023 |
0.20.1 | 124 | 12/5/2023 |
0.20.0 | 820 | 12/5/2023 |
0.19.1 | 153 | 11/25/2023 |
0.19.0 | 111 | 11/23/2023 |
0.18.4 | 139 | 11/23/2023 |
0.18.3 | 118 | 11/23/2023 |
0.18.2 | 111 | 11/22/2023 |
0.18.1 | 566 | 11/6/2023 |
0.18.0 | 144 | 11/1/2023 |
0.17.1 | 119 | 10/20/2023 |
0.16.0 | 166 | 9/26/2023 |
0.15.1 | 2,208 | 6/23/2023 |
0.15.0 | 152 | 6/23/2023 |
0.14.1 | 147 | 6/22/2023 |
0.14.0 | 364 | 11/30/2022 |
0.13.0 | 431 | 10/7/2022 |
0.12.0 | 4,158 | 1/6/2022 |
0.11.3 | 3,726 | 12/27/2021 |
0.11.2 | 310 | 12/27/2021 |
0.11.1 | 311 | 12/26/2021 |
0.11.0 | 335 | 12/23/2021 |
0.10.2 | 311 | 12/22/2021 |
0.10.1 | 310 | 12/20/2021 |
0.10.0 | 409 | 12/15/2021 |
0.9.1 | 710 | 10/25/2021 |
0.9.0 | 368 | 10/25/2021 |
0.8.1 | 2,754 | 10/9/2021 |
0.8.0 | 829 | 9/7/2021 |
0.7.0 | 598 | 8/19/2021 |
0.6.3 | 729 | 8/9/2021 |
0.6.2 | 379 | 8/9/2021 |
0.6.1 | 356 | 8/9/2021 |
0.6.0 | 385 | 8/9/2021 |
0.5.0 | 402 | 7/8/2021 |
0.4.0 | 701 | 4/13/2021 |
0.3.1 | 372 | 4/13/2021 |
0.2.1 | 376 | 4/9/2021 |
0.2.0 | 372 | 4/6/2021 |
0.1.0 | 513 | 3/17/2021 |