#cqrs #core

cqrs-core

Core types and traits for cqrs

4 releases

0.2.2 Sep 5, 2019
0.2.1 Apr 29, 2019
0.2.0 Apr 29, 2019
0.1.1 Mar 8, 2019
0.1.0 Feb 1, 2019

#331 in Asynchronous

Download history 100/week @ 2020-11-07 75/week @ 2020-11-14 103/week @ 2020-11-21 174/week @ 2020-11-28 356/week @ 2020-12-05 376/week @ 2020-12-12 2/week @ 2020-12-19 229/week @ 2020-12-26 300/week @ 2021-01-02 501/week @ 2021-01-09 151/week @ 2021-01-16 507/week @ 2021-01-23 401/week @ 2021-01-30 278/week @ 2021-02-06 214/week @ 2021-02-13 256/week @ 2021-02-20

67 downloads per month
Used in 4 crates

Apache-2.0

22KB
460 lines

cqrs

cqrs is an event-driven framework for writing software that uses events as the "source of truth" and implements command–query responsibility separation (CQRS).

The framework is built around a few key concepts:

  • Events: The things that happened in the system
  • Aggregates: Projections of events that calculate a view of the current state of the system
  • Commands: Intentions which, when executed against an aggregate, may produce zero or more events, or which may be prohibited by the current state of an aggregate
  • Reactions: Processes that execute an action when certain events occur in the system

The framework is written to be applicable to a generic backend, with an implementation provided for a PostgreSQL backend.

For an example of how to construct a domain which includes aggregates, events, and commands, look at the cqrs-todo-core crate, which is a simple to-do list implementation.

The source repository also contains a binary in the cqrs-todoql-psql directory which demonstrates the use of the todo domain in concert with the PostgreSQL backend and a GraphQL frontend using the juniper crate.

Minimum supported version of the Rust compiler is currently 1.32.

Development

To build all crates in this repository:

cargo build

To test all crates and documentation:

cargo test

To compile documentation for the crates in the repository (remove --no-deps to also include documentation for dependencies; add --open to automatically open the documentation in a browser):

cargo doc --no-deps

This crate aims to support the wasm32-unknown-unknown target for the cqrs, cqrs-core, and cqrs-todo-core crates. To build against this target, execute:

cargo build --target=wasm32-unknown-unknown -p cqrs-core -p cqrs -p cqrs-todo-core

License

cqrs is openly-licensed under the Apache-2.0 license.

No runtime deps