distributed 3.3.0

CQRS/ES framework for Rust using Plain Old Rust Structs — append-only events, replay, snapshots, outbox, service bus, and pluggable infrastructure
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

//! Lock - Pluggable locking abstractions
//!
//! This module provides traits and implementations for per-entity locking,
//! used by `QueuedRepository` to serialize aggregate access.
//!
//! ## Architecture
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────────┐
//! │              LockManager (per repository)                    │
//! │  - get_lock(id) → Arc<Lock>                                 │
//! └─────────────────────────────────────────────────────────────┘
//!                            │
//!                            ▼
//! ┌─────────────────────────────────────────────────────────────┐
//! │                     Lock Trait                               │
//! │  lock() / try_lock() / unlock()                              │
//! └─────────────────────────────────────────────────────────────┘
//!          │                  │                     │
//!          ▼                  ▼                     ▼
//! ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
//! │  InMemoryLock   │  │   PostgresLock   │  │    SqliteLock    │
//! │   (process-local)│  │ (durable lease,  │  │ (durable lease,  │
//! │                  │  │  feature=postgres│  │  feature=sqlite) │
//! └──────────────────┘  └──────────────────┘  └──────────────────┘
//! ```
//!
//! The SQLx locks ([`PostgresLock`]/[`SqliteLock`]) persist a per-stream lease in
//! the `aggregate_locks` table so a `QueuedRepository` can serialize aggregate
//! access across processes.

mod error;
mod in_memory;
mod lock;
mod manager;
#[cfg(feature = "postgres")]
mod postgres_lock;
#[cfg(feature = "sqlite")]
mod sqlite_lock;
#[cfg(any(feature = "postgres", feature = "sqlite"))]
mod sqlx_common;

pub use error::{LockError, RetryClass};
pub use in_memory::{InMemoryLock, InMemoryLockFuture, InMemoryLockManager};
pub use lock::Lock;
pub use manager::LockManager;
#[cfg(feature = "postgres")]
pub use postgres_lock::{PostgresDialect, PostgresLock, PostgresLockManager};
#[cfg(feature = "sqlite")]
pub use sqlite_lock::{SqliteDialect, SqliteLock, SqliteLockManager};
#[cfg(any(feature = "postgres", feature = "sqlite"))]
pub use sqlx_common::{LockDialect, SqlxLock, SqlxLockManager};