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
81
82
83
84
85
86
87
88
89
90
91
92
//! Error type for `orbit-rs`. Deliberately small — this layer has few
//! independent failure modes.
use std::fmt;
pub type Result<T, E = Error> = std::result::Result<T, E>;
#[derive(Debug)]
pub enum Error {
/// `Fleet::join` was called twice in the same process.
AlreadyJoined { name: &'static str },
/// Fleet size cannot be zero — Orbit's plurality requirement (see VISION §2).
EmptyFleet,
/// A cache frame could not fit into the current ring payload.
CacheFrameTooLarge {
key_len: usize,
value_len: usize,
max_payload: usize,
},
/// An event frame could not fit into the current ring payload.
EventFrameTooLarge {
topic_len: usize,
payload_len: usize,
max_payload: usize,
},
/// A contest frame could not fit into the current ring payload.
ContestFrameTooLarge {
subject_len: usize,
owner_len: usize,
max_payload: usize,
},
/// Shared-memory ring operation failed.
Io(std::io::Error),
}
impl fmt::Display for Error {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
Self::AlreadyJoined { name } => {
write!(f, "fleet '{name}' has already been joined in this process")
}
Self::EmptyFleet => {
write!(f, "fleet_size must be ≥ 1; Orbit needs at least one member")
}
Self::CacheFrameTooLarge {
key_len,
value_len,
max_payload,
} => {
write!(
f,
"orbit cache frame too large: key_len={key_len} value_len={value_len} max_payload={max_payload}"
)
}
Self::EventFrameTooLarge {
topic_len,
payload_len,
max_payload,
} => {
write!(
f,
"orbit event frame too large: topic_len={topic_len} payload_len={payload_len} max_payload={max_payload}"
)
}
Self::ContestFrameTooLarge {
subject_len,
owner_len,
max_payload,
} => {
write!(
f,
"orbit contest frame too large: subject_len={subject_len} owner_len={owner_len} max_payload={max_payload}"
)
}
Self::Io(err) => write!(f, "orbit io error: {err}"),
}
}
}
impl std::error::Error for Error {
fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
match self {
Self::Io(err) => Some(err),
_ => None,
}
}
}