acktor 1.1.0

Pure-Rust actor framework built on top of the Tokio async runtime
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

use thiserror::Error;

use crate::error::BoxError;

/// Error type used by [`Encode`][crate::codec::Encode].
#[derive(Debug, Error)]
pub enum EncodeError {
    #[error("missing encode context")]
    MissingEncodeContext,

    #[error("remote address should not be encoded into a message")]
    EncodeRemoteAddress,

    #[error("the actor is not remote addressable")]
    NotRemoteAddressable,

    #[error("could not encode the message")]
    Other(#[source] BoxError),
}

impl EncodeError {
    /// Constructs a new [`EncodeError`] from an arbitrary error.
    pub fn other<E>(err: E) -> Self
    where
        E: Into<BoxError>,
    {
        EncodeError::Other(err.into())
    }
}

impl From<BoxError> for EncodeError {
    #[inline]
    fn from(e: BoxError) -> Self {
        Self::other(e)
    }
}

impl From<String> for EncodeError {
    #[inline]
    fn from(s: String) -> Self {
        Self::other(s)
    }
}

impl From<&str> for EncodeError {
    #[inline]
    fn from(s: &str) -> Self {
        Self::other(s)
    }
}

impl From<prost::EncodeError> for EncodeError {
    #[inline]
    fn from(e: prost::EncodeError) -> Self {
        Self::other(e)
    }
}

/// Error type used by [`Decode`][crate::codec::Decode].
#[derive(Debug, Error)]
pub enum DecodeError {
    #[error("missing decode context")]
    MissingDecodeContext,

    #[error("message should not contain a remote address")]
    DecodeRemoteAddress,

    #[error("unknown message id: {0}")]
    UnknownMessageId(u64),

    #[error("decode context does not contain a remote proxy")]
    MissingRemoteProxy,

    #[error("could not decode the message")]
    Other(#[source] BoxError),
}

impl DecodeError {
    /// Constructs a new [`DecodeError`] from an arbitrary error.
    pub fn other<E>(err: E) -> Self
    where
        E: Into<BoxError>,
    {
        DecodeError::Other(err.into())
    }
}

impl From<BoxError> for DecodeError {
    #[inline]
    fn from(e: BoxError) -> Self {
        Self::other(e)
    }
}

impl From<String> for DecodeError {
    #[inline]
    fn from(s: String) -> Self {
        Self::other(s)
    }
}

impl From<&str> for DecodeError {
    #[inline]
    fn from(s: &str) -> Self {
        Self::other(s)
    }
}

impl From<prost::DecodeError> for DecodeError {
    #[inline]
    fn from(e: prost::DecodeError) -> Self {
        Self::other(e)
    }
}

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

    #[test]
    fn test_encode_decode_errors() {
        let from_str: EncodeError = "boom".into();
        assert!(matches!(from_str, EncodeError::Other(_)));
        let from_string: EncodeError = String::from("boom").into();
        assert!(matches!(from_string, EncodeError::Other(_)));
        let boxed: BoxError = "boom".into();
        let from_box: EncodeError = boxed.into();
        assert!(matches!(from_box, EncodeError::Other(_)));

        let from_str: DecodeError = "boom".into();
        assert!(matches!(from_str, DecodeError::Other(_)));
        let from_string: DecodeError = String::from("boom").into();
        assert!(matches!(from_string, DecodeError::Other(_)));
        let boxed: BoxError = "boom".into();
        let from_box: DecodeError = boxed.into();
        assert!(matches!(from_box, DecodeError::Other(_)));
    }
}