cortexfs-channels 0.1.0

Runtime-neutral multi-channel messaging abstractions for agents.
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

use std::time::Duration;

/// Stable failures returned by channel adapters and the registry.
#[derive(Clone, Debug, Eq, PartialEq, thiserror::Error)]
pub enum ChannelError {
    #[error("invalid channel value: {0}")]
    InvalidValue(String),
    #[error("invalid channel message: {0}")]
    InvalidMessage(String),
    #[error("channel already registered: {0}")]
    DuplicateChannel(String),
    #[error("unknown channel: {0}")]
    UnknownChannel(String),
    #[error("channel operation unsupported: {0}")]
    Unsupported(String),
    #[error("channel authentication failed")]
    Authentication,
    #[error("channel rate limited")]
    RateLimited { retry: RetryHint },
    #[error("channel transport failed: {0}")]
    Transport(String),
    #[error("channel protocol failed: {0}")]
    Protocol(String),
    #[error("channel is closed")]
    Closed,
}

/// Optional retry advice attached to a rate-limit failure.
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
pub struct RetryHint(Option<Duration>);

impl RetryHint {
    #[must_use]
    pub const fn none() -> Self {
        Self(None)
    }

    #[must_use]
    pub const fn after(delay: Duration) -> Self {
        Self(Some(delay))
    }

    #[must_use]
    pub const fn delay(self) -> Option<Duration> {
        self.0
    }
}