pass-it-on 0.17.3

A library that provides a simple notification client and server that receives messages and passes them on to endpoints
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

use thiserror::Error;
use thiserror_ext::{Box, Construct};

/// Errors returned by pass-it-on library.
#[derive(Error, Debug, Box, Construct)]
#[thiserror_ext(newtype(name = Error))]
pub enum ErrorKind {
    /// At least one [`Endpoint`][`crate::endpoints::Endpoint`] needs to be defined for a server.
    #[error("At least one endpoint must be defined")]
    MissingEndpoint,

    /// At least one [`Interface`][`crate::interfaces::Interface`] needs to be defined for a server or client.
    #[error("At least one interface must be defined")]
    MissingInterface,

    /// Validation failed for an [`InterfaceConfig`][`crate::interfaces::InterfaceConfig`].
    #[error("Invalid Interface Configuration: {0}")]
    InvalidInterfaceConfiguration(String),

    /// Validation failed for an [`EndpointConfig`][`crate::endpoints::EndpointConfig`].
    #[error("Invalid Endpoint Configuration: {0}")]
    InvalidEndpointConfiguration(String),

    /// matrix room name does not appear to be a room.
    #[error("Room identifiers must start with # or !")]
    InvalidMatrixRoomIdentifier,

    /// Port needs to be in a valid u16 range.
    #[error("Invalid port number, valid u16 value expected and got {0}")]
    InvalidPortNumber(i64),

    /// Call to an interface feature that is not enabled.
    #[error("Interface feature {0} is not enabled")]
    DisabledInterfaceFeature(String),

    /// Return when an endpoint feature is called but not enabled
    #[error("Endpoint feature {0} is not enabled")]
    DisabledEndpointFeature(String),

    // ### Converting from other error types ###
    /// Pass-thru [`std::io::Error`].
    #[error("std::io Error: {0}")]
    IOError(#[from] std::io::Error),

    /// Pass-thru `serde_json::Error`.
    #[error("Serde_json Error: {0}")]
    SerdeJsonError(#[from] serde_json::Error),

    #[cfg(feature = "parse-cfg")]
    /// Pass-thru `toml::de::Error`.
    #[error("Serde Toml Error: {0}")]
    SerdeTomlError(#[from] toml::de::Error),

    #[cfg(feature = "matrix")]
    /// Pass-thru `matrix_sdk::Error`.
    #[error("Matrix_SDK Error: {0}")]
    MatrixSDKError(#[from] matrix_sdk::Error),

    #[cfg(feature = "matrix")]
    /// Pass-thru `matrix_sdk::ClientBuildError`.
    #[error("Matrix ClientBuild Error: {0}")]
    MatrixClientBuildError(#[from] matrix_sdk::ClientBuildError),

    #[cfg(feature = "matrix")]
    /// Pass-thru `matrix_sdk::encryption::secret_storage::SecretStorageError`.
    #[error("Matrix SecretStorage Error: {0}")]
    MatrixSecretStoreError(#[from] matrix_sdk::encryption::secret_storage::SecretStorageError),

    #[cfg(feature = "matrix")]
    /// Pass-thru `matrix_sdk::encryption::recovery::RecoveryError`.
    #[error("Matrix RecoveryError Error: {0}")]
    MatrixRecoveryError(#[from] matrix_sdk::encryption::recovery::RecoveryError),

    #[cfg(all(unix, any(feature = "pipe-client", feature = "pipe-server", feature = "pipe")))]
    /// Pass-thru `nix::errno::Errno`.
    #[error("Nix ErrorNo Error: {0}")]
    NixErrorNoError(#[from] nix::errno::Errno),

    #[cfg(any(feature = "http-client", feature = "http-server"))]
    /// Pass-thru `url::ParseError`.
    #[error("Url Parse Error: {0}")]
    UrlParseError(#[from] url::ParseError),

    #[cfg(feature = "email")]
    /// Pass-thru `mail_send::Error`.
    #[error("Mail Send Error: {0}")]
    MailSendError(#[from] mail_send::Error),
}