jangocheng / manta

Event store library for .NET Core based on rdbms persistance.

Manta

Event store library for .NET Core based on rdbms persistance.

A thin (but powerful) slice of library between your code and rdbms.

Status

ALMOST READY FOR PRODUCTION USAGE

Installation

Manta is not available on NuGet, yet.

You can download source code from this repository and compile under Visual Studio 2017.

Main goals

Done

• Async all the way down
• No external dependencies
• Pluggable persistance storage
• Idempotent writes
• Support optimistic concurrency
• Support any kind of message serialization
• Support any kind of loggers through ILogger interface for Manta internal logging
• Support up-conversion of events to the newest version
• Subscriptions to one or many event stream sources for processmanagers/projections/others
• MS SQL Server - Manta implementation (with single-writer pattern)
• MS SQL Server - Manta.Projections implementation

last but not least, performance

• on i5 2500k with SSD benchmarked ~15,000 writes per second
• on i7 8700k with SSD benchmarked ~25,000 writes per second (reading streams are really fast)

SSD disk speed is an important factor

To be done

• Manta - InMemory implementation
• Manta.Projections - InMemory implementation
• Manta.PostgreSql - PostgreSql implementation
• Manta.MySql - MySql implementation
• Manta.SqLite - SqLite implementation

Others

• Manta.Domain (as different repository)
  • Manta.Domain - Conflict resolver, repository pattern, unit of work, e.t.c.

Getting started

// Simple class representing event/message which will be stored

[DataContract]
public class SomeEvent
{
    [DataMember(Order = 1)]
    public string Name { get; private set; }

    public SomeEvent(string name)
    {
        Name = name;
    }
}

// Basic example of usage

ISerializer serializer = new JilSerializer(); // You can use any type of serialization method
ArraySegment<byte> payload = serializer.Serialize(ev);
string contractName = GetContractNameBasedOnEventType(ev.GetType());

var data = new UncommittedMessages(
    SequentialGuid.NewGuid(), // correlationId
    new []
    {
        new MessageRecord(
            SequentialGuid.NewGuid(), // messageId
            contractName,
            payload)
    });

await store.AppendToStream(
    "stream-1",
    ExpectedVersion.NoStream,
    data);

More examples you can find on wiki.

Documentation

If you're looking for documentation, you can find it here.

Contributing

A contribution is welcome. Checkout contributing rules.