acktor 1.0.14

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
139
140
141
142
143
144
145
146
147

use std::fmt::{Debug, Display};
use std::ops::Deref;

use thiserror::Error;
use zerocopy::{KnownLayout, TryFromBytes};

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(transparent)]
    ProstEncodeError(#[from] prost::EncodeError),

    #[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 {
    fn from(e: BoxError) -> Self {
        Self::Other(e)
    }
}

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

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

/// 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(transparent)]
    ProstDecodeError(#[from] prost::DecodeError),

    #[error("could not decode the message: {0}")]
    ZerocopyError(String),

    #[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 {
    fn from(e: BoxError) -> Self {
        Self::Other(e)
    }
}

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

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

impl<A, S, V> From<zerocopy::ConvertError<A, S, V>> for DecodeError
where
    A: Debug + Display,
    S: Debug + Display,
    V: Debug + Display,
{
    fn from(err: zerocopy::ConvertError<A, S, V>) -> Self {
        DecodeError::ZerocopyError(err.to_string())
    }
}

impl<Src, Dst> From<zerocopy::AlignmentError<Src, Dst>> for DecodeError
where
    Src: Deref,
    Dst: KnownLayout + ?Sized,
{
    fn from(err: zerocopy::AlignmentError<Src, Dst>) -> Self {
        DecodeError::ZerocopyError(err.to_string())
    }
}

impl<Src, Dst> From<zerocopy::SizeError<Src, Dst>> for DecodeError
where
    Src: Deref,
    Dst: KnownLayout + ?Sized,
{
    fn from(err: zerocopy::SizeError<Src, Dst>) -> Self {
        DecodeError::ZerocopyError(err.to_string())
    }
}

impl<Src, Dst> From<zerocopy::ValidityError<Src, Dst>> for DecodeError
where
    Dst: KnownLayout + TryFromBytes + ?Sized,
{
    fn from(err: zerocopy::ValidityError<Src, Dst>) -> Self {
        DecodeError::ZerocopyError(err.to_string())
    }
}