Giter Club home page Giter Club logo

eshelpers's Introduction

ESHelpers - Eventsourcing Helpers for c#

Welcome to the ESHelpers project to make your eventsourcing life easier

Project information

Status
Build status Build status
Code coverage status Coverage Status
Latest Release GitHub tag (latest by date)
NuGET version Nuget release
License License: GPL v3

Why these helpers?

These helpers should make your life easier when building components related to eventsourcing like:

  • Stop doing figuring out / copy pasting the same things in every project
  • Creating and restoring aggregate roots
  • Dealing with situations where you need to comply to GPDR rules like PII
  • Dealing with hashed values like passwords

It's just time to build your domains

What's in it for the future?

  • Making processors easy
  • Making saga's easy

Documentation:

Easy? Well let's go!! How can we start?

Technical Documentation

FAQ

Which eventstores are currently supported?

Currently there is only support for EventStoreDB and there is an InMemory store (mainly used for unittesting). Over time I might build additional support different technologies. If you have a specials then please leave it at the issue tracker.

Which stores for encryption are currently supported?

Currently there is only support for MySQL as a crypto store however just like with the eventstore support if you have special requests then please leave an issue on the issue tracker.

What are the best strategies for unittesting?

For the Eventstores and the crypto stores there is an InMemory alternative. These InMemory versions are perfectly suitable for this purpose. Sometimes these InMemory versions also have some extra methods to make testing easier.

eshelpers's People

Contributors

weemen avatar

Watchers

 avatar

eshelpers's Issues

Create aggregate root base class

Make implementations easer to let users worry less about some default behaviour which should happen in every aggregate root like:

  • public Guid getAggregateRootId()
  • public List<IDomainEvent> getUncommittedEvents()
  • public void setExpectedPlayHead(int expectedPlayHead)
  • public int getPlayHead()
  • private void Record(IDomainEvent e)

Create a cache helper to prevent looking up and storing fully qualified event names

I need to create a cache helper to prevent storing event with their fully qualified namespaces. There multiple reasons to have this:

1: First of all, fully qualified namespaces are ugly and in polyglot systems it does not make sense!
2: There is another hidden problem here. During the creation of the unittests I found out that, the fully qualified namespaces is sometimes not sufficient. The dummy event created in the unittest is living in a different assembly and therefor cannot be found in other assemblies.

We can solve these issues with creating a cache on boot of the application, this cache should be a simple list with the class name and the fully qualified name + the assembly name. This cache can easily live on disk since the events should be living in one of the assemblies around the application anyway.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.