rails_event_store

Rails Event Store

Rails Event Store (RES) is a library for publishing, consuming, storing and retrieving events. It's your best companion for going with an event-driven architecture for your Rails application.

You can use it:

• as your Publish-Subscribe bus
• to decouple core business logic from external concerns in Hexagonal style architectures
• as an alternative to ActiveRecord callbacks and Observers
• as a communication layer between loosely coupled components
• to react to published events synchronously or asynchronously
• to extract side-effects (notifications, metrics etc) from your controllers and services into event handlers
• to build an audit-log
• to create read-models
• to implement event-sourcing

Documentation

Documentation, tutorials and code samples are available at https://railseventstore.org.

Code status

This single repository hosts several gems and website with documentation — see the contribution guide.

We're aiming for 100% mutation coverage in this project. This is why:

• Why I want to introduce mutation testing to the rails_event_store gem
• Mutation testing and continuous integration

Whenever you fix a bug or add a new feature, we require that the coverage doesn't go down.

RailsEventStore gems

Name CI Version Downloads rails_event_store ruby_event_store-active_record ruby_event_store ruby_event_store-browser ruby_event_store-rspec aggregate_root

Contributed gems

Name CI Version Downloads ruby_event_store-outbox ruby_event_store-protobuf ruby_event_store-profiler ruby_event_store-flipper ruby_event_store-transformations ruby_event_store-rom ruby_event_store-sidekiq_scheduler ruby_event_store-cli ruby_event_store-mcp ruby_event_store-process_manager ruby_event_store-sequel

Unreleased contributed gems

Name CI ruby_event_store-newrelic minitest-ruby_event_store dres_rails dres_client

About