Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asynchandler/asynchandler.eventsourcing
Lightweight event sourcing framework for .Net with event-store of choice.
https://github.com/asynchandler/asynchandler.eventsourcing
azuresql ci dotnet event-driven event-sourcing event-store postgres sqlserver
Last synced: 8 days ago
JSON representation
Lightweight event sourcing framework for .Net with event-store of choice.
- Host: GitHub
- URL: https://github.com/asynchandler/asynchandler.eventsourcing
- Owner: asynchandler
- License: mit
- Created: 2024-08-22T12:47:26.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2024-09-23T22:59:58.000Z (10 days ago)
- Last Synced: 2024-09-25T20:03:01.225Z (8 days ago)
- Topics: azuresql, ci, dotnet, event-driven, event-sourcing, event-store, postgres, sqlserver
- Language: C#
- Homepage:
- Size: 188 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# asynchandler
### A lightweight event sourcing framework designed for your event-store of choice.
[](https://github.com/asynchandler)
[](https://github.com/eventsourcer)
[](https://www.linkedin.com/in/sarwansurchi/)
[](https://www.nuget.org/packages/AsyncHandler.EventSourcing)
[](https://www.nuget.org/packages/AsyncHandler.EventSourcing)
[](https://github.com/asynchandler/AsyncHandler.EventSourcing)
[](https://dev.azure.com/asynchandler/AsyncHandler.EventSourcing/_build/latest?definitionId=11&branchName=main)
### Overview
asynchandler is a high-performance event sourcing framework built for .Net that allows selecting event storage of choice. Combining consistency with schema flexibility, asynchandler aims to simplify event sourcing for everyone. Currently supports Azure Sql database and Sql Server, with Postgres and others in the upcoming releases.
### Environment setup
[](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
asynchandler runs on the stable release of .Net 8 and requires the SDK installed:
https://dotnet.microsoft.com/en-us/download/dotnet/8.0
[](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
Use docker to run sqlserver or postgres databases, execute `docker-compose` or `docker run`:
docker compose --project-name some-name up -d
`Postgres`
docker run --name some-postgres -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d postgres
`SqlServer`
docker run --name some-mssql -p 1433:1433 -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=password" -d mcr.microsoft.com/mssql/server:2019-latest
### Getting started
[](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
#### Install the package
###### Simply install `AsyncHandler.EventSourcing` package.
dotnet add package AsyncHandler.EventSourcing
#### Configure your event source
###### Use `AddAsyncHandler` service collection extension.
```csharp
builder.Services.AddAsyncHandler(asynchandler =>
{
asynchandler.AddEventSourcing(source =>
{
source.SelectEventSource(EventSources.AzureSql, connectionString);
});
});
```
Select your event source of choice from `SelectEventSource`, currently AzureSql and SqlServer are supported.
Make sure you have defined your connection string from appsettings.
#### Define your aggregate
###### Add your aggregate with AggregateRoot
```csharp
public class OrderBookingAggregate : AggregateRoot // or Guid
{
public OrderStatus OrderStatus { get; private set; }
protected override void Apply(SourcedEvent e)
{
this.InvokeApply(e);
}
public void Apply(OrderPlaced e)
{
OrderStatus = OrderStatus.Placed;
}
public void PlaceOrder(PlaceOrder command)
{
if(OrderStatus == OrderStatus.Placed)
return;
RaiseEvent(new OrderPlaced(command));
}
}
```
#### Use `IEventSource` service
```csharp
app.MapPost("api/placeorder",
async(IEventSource eventSource, PlaceOrder command) =>
{
var aggregate = await eventSource.CreateOrRestore();
aggregate.PlaceOrder(command);
await eventSource.Commit(aggregate);
});
```
Add two more methods to your aggregate to confirm an order, `ConfirmOrder` and `Apply(OrderConfirmed)`:
```csharp
app.MapPost("api/confirmorder/{orderId}",
async(IEventSource eventSource, long orderId, ConfirmOrder command) =>
{
var aggregate = await eventSource.CreateOrRestore(orderId);
aggregate.ConfirmOrder(command);
await eventSource.Commit(aggregate);
});
```
Please notice, these are early moments of asynchandler and the framework doesn't yet offer full event sourcing functionality.
### Give us a ⭐
If you are an event sourcer and love OSS, give [asynchandler](https://github.com/asynchandler/AsyncHandler.EventSourcing) a star. :purple_heart:
### License
This project is licensed under the terms of the [MIT](https://github.com/asynchandler/AsyncHandler.EventSourcing/blob/main/LICENSE) license.