cruster 0.0.27

A Rust framework for building distributed, stateful entity systems with durable workflows
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

use crate::snowflake::Snowflake;
use crate::types::{EntityAddress, EntityId, EntityType, RunnerAddress};

/// Errors that can occur in the cluster system.
#[derive(Debug, thiserror::Error)]
pub enum ClusterError {
    #[error("entity {entity_type}/{entity_id} not assigned to this runner")]
    EntityNotAssignedToRunner {
        entity_type: EntityType,
        entity_id: EntityId,
    },

    #[error("malformed message: {reason}")]
    MalformedMessage {
        reason: String,
        #[source]
        source: Option<Box<dyn std::error::Error + Send + Sync>>,
    },

    #[error("persistence error: {reason}")]
    PersistenceError {
        reason: String,
        #[source]
        source: Option<Box<dyn std::error::Error + Send + Sync>>,
    },

    #[error("runner not registered: {address}")]
    RunnerNotRegistered { address: RunnerAddress },

    #[error("runner unavailable: {address}")]
    RunnerUnavailable {
        address: RunnerAddress,
        #[source]
        source: Option<Box<dyn std::error::Error + Send + Sync>>,
    },

    #[error("mailbox full for {address}")]
    MailboxFull { address: EntityAddress },

    #[error("already processing message {request_id}")]
    AlreadyProcessingMessage { request_id: Snowflake },

    #[error("cluster is shutting down")]
    ShuttingDown,

    #[error("invalid configuration: {reason}")]
    InvalidConfig { reason: String },

    #[error(transparent)]
    ClockDriftExceeded(#[from] crate::snowflake::SnowflakeError),
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn error_display_messages() {
        let err = ClusterError::EntityNotAssignedToRunner {
            entity_type: EntityType::new("User"),
            entity_id: EntityId::new("123"),
        };
        assert_eq!(
            err.to_string(),
            "entity User/123 not assigned to this runner"
        );

        let err = ClusterError::MalformedMessage {
            reason: "bad payload".into(),
            source: None,
        };
        assert_eq!(err.to_string(), "malformed message: bad payload");
    }

    #[test]
    fn errors_are_send_sync() {
        fn assert_send_sync<T: Send + Sync>() {}
        assert_send_sync::<ClusterError>();
    }
}