Event Sourcing in Python

A library for event sourcing in Python.

Overview

What is event sourcing? One definition suggests the state of an event sourced application is determined by a sequence of events. Another definition has event sourcing as a persistence mechanism for domain driven design. It is common for the state of a software application to be modelled across a set of entities or aggregates.

Therefore, this library provides mechanisms for event sourced applications, a way for domain events to be stored and replayed, and a style for coding entities with both state that is driven by events and behaviour that drives events.

This documentation provides: instructions for installing the package, highlights the main features of the library, describes the design of the software, the infrastructure layer, the domain model layer, the application layer, has information about deployment, and has some background information about the project.

This project is hosted on GitHub. Please register any issues, questions, and requests on GitHub.

Contents

• Background
• Quick start
  • Define model
  • Configure environment
  • Run application
• Installation
• Features
• Design
• Infrastructure
  • Sequenced item type
  • Sequenced item mapper
  • Record managers
  • Event store
• Domain model
  • Domain events
  • Domain entities
  • Aggregate root
• Application
  • Overview
  • Simple application
  • Custom application
• Snapshotting
  • Domain
  • Application
  • Run the code
• Stand-alone example
  • Domain
  • Infrastructure
  • Application
  • Run the code
• Notifications
  • Application sequence
  • Notification logs
  • Local notification logs
  • Remote notification logs
  • Notification log reader
  • Updating projections
• Deployment
  • Application object
  • Database connection
  • Web interfaces
  • Task queues
• Release notes
• Module docs
  • eventsourcing