LiteBus.Messaging.Abstractions
0.20.1
See the version list below for details.
dotnet add package LiteBus.Messaging.Abstractions --version 0.20.1
NuGet\Install-Package LiteBus.Messaging.Abstractions -Version 0.20.1
<PackageReference Include="LiteBus.Messaging.Abstractions" Version="0.20.1" />
paket add LiteBus.Messaging.Abstractions --version 0.20.1
#r "nuget: LiteBus.Messaging.Abstractions, 0.20.1"
// Install LiteBus.Messaging.Abstractions as a Cake Addin #addin nuget:?package=LiteBus.Messaging.Abstractions&version=0.20.1 // Install LiteBus.Messaging.Abstractions as a Cake Tool #tool nuget:?package=LiteBus.Messaging.Abstractions&version=0.20.1
<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">An easy-to-use and ambitious in-process mediator to implement 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 a detailed understanding and advanced use cases, please refer to the <a href="https://github.com/litenova/LiteBus/wiki"><b>Wiki</b></a>. </p>
Features
- Developed with .NET 8.0
- Independent (No external dependencies)
- Reduced use of reflection
- Provides polymorphic dispatch and handling of messages with support for covariance and contravariance
- Core Messaging Types include:
ICommand
: Command without resultICommand<TResult>
: Command with a resultIQuery<TResult>
: QueryIStreamQuery<TResult>
: Query yieldingIAsyncEnumerable<TResult>
IEvent
: Event
- Designed for flexibility and extensibility
- Modular architecture: Abstractions and implementations are provided in distinct packages
- Allows ordering of handlers
- Can handle plain messages (class types without specific interface implementations)
- Supports generic messages
- Features both global and individual pre and post handlers. These handlers also support covariance and contravariance
- Events do not necessarily need to inherit from
IEvent
, accommodating DDD scenarios. This is beneficial for maintaining clean domain events without binding them to any particular library interface.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. 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. |
-
net7.0
- No dependencies.
NuGet packages (6)
Showing the top 5 NuGet packages that depend on LiteBus.Messaging.Abstractions:
Package | Downloads |
---|---|
LiteBus.Commands.Abstractions
LiteBus is an easy-to-use and ambitious in-process mediator providing the foundation to implement Command Query Separation (CQS). It is implemented with minimal reflection and instead utilizes covariance and contravariance to provide its core functionality. |
|
LiteBus.Queries.Abstractions
LiteBus is an easy-to-use and ambitious in-process mediator providing the foundation to implement Command Query Separation (CQS). It is implemented with minimal reflection and instead utilizes covariance and contravariance to provide its core functionality. |
|
LiteBus.Messaging
LiteBus is an easy-to-use and ambitious in-process mediator providing the foundation to implement Command Query Separation (CQS). It is implemented with minimal reflection and instead utilizes covariance and contravariance to provide its core functionality. |
|
LiteBus.Events.Abstractions
LiteBus is an easy-to-use and ambitious in-process mediator providing the foundation to implement Command Query Separation (CQS). It is implemented with minimal reflection and instead utilizes covariance and contravariance to provide its core functionality. |
|
LiteBus.Events
LiteBus is an easy-to-use and ambitious in-process mediator providing the foundation to implement Command Query Separation (CQS). It is implemented with minimal reflection and instead utilizes covariance and contravariance to provide its core functionality. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
0.24.3 | 1,414 | 5/2/2024 |
0.24.2 | 278 | 4/16/2024 |
0.24.1 | 227 | 1/30/2024 |
0.23.1 | 2,252 | 1/11/2024 |
0.23.0 | 319 | 12/23/2023 |
0.22.0 | 269 | 12/23/2023 |
0.21.0 | 293 | 12/18/2023 |
0.20.2 | 329 | 12/8/2023 |
0.20.1 | 277 | 12/5/2023 |
0.20.0 | 1,246 | 12/5/2023 |
0.19.1 | 231 | 11/25/2023 |
0.19.0 | 240 | 11/23/2023 |
0.18.4 | 314 | 11/23/2023 |
0.18.3 | 303 | 11/23/2023 |
0.18.2 | 318 | 11/22/2023 |
0.18.1 | 927 | 11/6/2023 |
0.18.0 | 341 | 11/1/2023 |
0.17.1 | 324 | 10/20/2023 |
0.16.0 | 419 | 9/26/2023 |
0.15.1 | 3,609 | 6/23/2023 |
0.15.0 | 669 | 6/23/2023 |
0.14.1 | 672 | 6/22/2023 |
0.14.0 | 1,064 | 11/30/2022 |
0.13.0 | 2,148 | 10/7/2022 |
0.12.0 | 9,571 | 1/6/2022 |
0.11.3 | 5,166 | 12/27/2021 |
0.11.2 | 1,320 | 12/27/2021 |
0.11.1 | 1,277 | 12/26/2021 |
0.11.0 | 1,299 | 12/23/2021 |
0.10.2 | 1,284 | 12/22/2021 |
0.10.1 | 1,263 | 12/20/2021 |
0.10.0 | 1,393 | 12/15/2021 |
0.9.1 | 2,072 | 10/25/2021 |
0.9.0 | 1,726 | 10/25/2021 |
0.8.1 | 5,094 | 10/9/2021 |
0.8.0 | 2,277 | 9/7/2021 |
0.7.0 | 2,538 | 8/19/2021 |
0.6.3 | 2,138 | 8/9/2021 |
0.6.2 | 1,734 | 8/9/2021 |
0.6.1 | 1,762 | 8/9/2021 |
0.6.0 | 1,784 | 8/9/2021 |
0.5.0 | 1,812 | 7/8/2021 |
0.4.0 | 2,086 | 4/13/2021 |
0.3.1 | 1,783 | 4/13/2021 |
0.2.1 | 1,676 | 4/9/2021 |
0.2.0 | 1,702 | 4/6/2021 |
0.1.0 | 1,798 | 3/17/2021 |
# Changelog
## v.0.20.1
- Rename `AddMessaging` method to `AddMessageModule`.
## v.0.20.0
- Revert TargetFramework to NET 7
## v.0.19.1
- Add `ThrowOnNoHandlers` to `EventMediationSettings` to allow throwing an exception when no handlers are found for an event.
- Fixed a bug where the pre and post handlers were being executed even when no main handlers were found.
## v.0.19.0
- Upgraded to .NET 8.
## v.0.18.4
- Rename `FilterHandler` to `HandlerFilter` on `EventMediationSettings` as it is more concise and directly states that it is a filter for handlers.
## v.0.18.3
- Add `EventMediationSettings` to IEventMediator to allow configuring event mediation.
- Add `FilterHandler` to `EventMediationSettings` to allow filtering event handlers.
## v.0.18.2
- Preserve the stack trace when rethrowing an exception in case there are no error handlers.
## v.0.18.1
- Make execution of event handlers synchronous by default.
## v.0.18.0
- All post handlers expose message result as the second parameter.
- Fixed a bug where IEventPreHandler was not asynchronous.
- Added more unit tests.
## v.0.17.1
- Add `Items` property to `IExecutionContext` to allow passing data between handlers.
## v.0.17.0
- Rename `AddCommands` method to `AddCommandModule`.
- Rename `AddEvents` method to `AddEventModule`.
- Rename `AddQueries` method to `AddQueryModule`.
## v.0.16.0
- Introduced execution context using AsyncLocal functionality, accessible through AmbientExecutionContext.
- Renamed `RegisterFrom` to `RegisterFromAssembly` in module builders.
- Standardized namespace for all files in the `LiteBus.Messaging.Abstractions` project to `LiteBus.Messaging.Abstractions`, irrespective of folder path.
- Removed `HandleContext` as a parameter from post and pre handlers.
## v.0.15.1
- Removed `IEvent` constraint from event handlers, allowing objects to be passed as events without implementing the `IEvent` interface.
## v.0.15.0
- Added overload method to event publisher for passing an object as a message.
- Removed `LiteBus` prefix from module constructor names.
## v.0.14.1
- Upgraded dependency packages.
## v.0.14.0
- Upgraded to .NET 7.
## v.0.13.0
- Replaced `ICommandBase` with `ICommand`.
- Replaced `IQueryBase` with `IQuery`.
- Renamed `ILiteBusModule` to `IModule`.
- Removed methods `RegisterPreHandler`, `RegisterHandler`, and `RegisterPostHandler`, replacing them with `Register`.
- Removed superfluous base interfaces.
## v.0.12.0
- Added support to message registry for registering any class type as a message.
## v.0.11.3
- Fixed bug: Execute error handlers instead of pre handlers during error phase.
## v.0.11.2
- Fixed bug: Considered the count of indirect error handlers when determining if an exception should be rethrown.
## v.0.11.1
- Disabled nullable reference types.
- Ensured error handlers cover errors in pre and post handlers.
## v.0.11.0
- Introduced non-generic message registration overloads for events, queries, and messaging configuration.
- Removed the sample project.
- Added unit tests for events and queries.