tokio_xmpp/
error.rs

1use core::{fmt, net::AddrParseError, str::Utf8Error};
2#[cfg(feature = "dns")]
3use hickory_resolver::{proto::ProtoError as DnsProtoError, ResolveError as DnsResolveError};
4use sasl::client::MechanismError as SaslMechanismError;
5use std::io;
6use thiserror::Error;
7
8use xmpp_parsers::stream_error::ReceivedStreamError;
9
10use crate::{
11    connect::ServerConnectorError, jid, minidom,
12    parsers::sasl::DefinedCondition as SaslDefinedCondition, xmlstream::RecvFeaturesError,
13};
14
15/// Top-level error type
16#[derive(Debug, Error)]
17pub enum Error {
18    /// I/O error
19    #[error("I/O error: {0}")]
20    Io(#[from] io::Error),
21    /// Error parsing Jabber-Id
22    #[error("JID parse error: {0}")]
23    JidParse(#[from] jid::Error),
24    /// Protocol-level error
25    #[error("protocol error: {0}")]
26    Protocol(#[from] ProtocolError),
27    /// Authentication error
28    #[error("authentication error: {0}")]
29    Auth(#[from] AuthError),
30    /// Connection closed
31    #[error("disconnected")]
32    Disconnected,
33    /// Should never happen
34    #[error("invalid state")]
35    InvalidState,
36    /// Fmt error
37    #[error("fmt error: {0}")]
38    Fmt(#[from] fmt::Error),
39    /// Utf8 error
40    #[error("UTF-8 error: {0}")]
41    Utf8(#[from] Utf8Error),
42    /// Error specific to ServerConnector impl
43    #[error("connection error: {0}")]
44    Connection(Box<dyn ServerConnectorError>),
45    /// DNS protocol error
46    #[cfg(feature = "dns")]
47    #[error("{0:?}")]
48    Dns(#[from] DnsProtoError),
49    /// DNS resolution error
50    #[cfg(feature = "dns")]
51    #[error("{0:?}")]
52    Resolve(#[from] DnsResolveError),
53    /// DNS label conversion error, no details available from module
54    /// `idna`
55    #[cfg(feature = "dns")]
56    #[error("IDNA error")]
57    Idna,
58    /// Invalid IP/Port address
59    #[error("wrong network address: {0}")]
60    Addr(#[from] AddrParseError),
61    /// Received a stream error
62    #[error("{0}")]
63    StreamError(ReceivedStreamError),
64}
65
66impl<T: ServerConnectorError + 'static> From<T> for Error {
67    fn from(e: T) -> Self {
68        Error::Connection(Box::new(e))
69    }
70}
71
72#[cfg(feature = "dns")]
73impl From<idna::Errors> for Error {
74    fn from(_e: idna::Errors) -> Self {
75        Error::Idna
76    }
77}
78
79impl From<RecvFeaturesError> for Error {
80    fn from(e: RecvFeaturesError) -> Self {
81        match e {
82            RecvFeaturesError::Io(e) => e.into(),
83            RecvFeaturesError::StreamError(e) => Self::StreamError(e),
84        }
85    }
86}
87
88/// XMPP protocol-level error
89#[derive(Debug, Error)]
90pub enum ProtocolError {
91    /// XML parser error
92    #[error("XML parser error: {0}")]
93    Parser(#[from] minidom::Error),
94    /// Error with expected stanza schema
95    #[error("error with expected stanza schema: {0}")]
96    Parsers(#[from] xso::error::Error),
97    /// No TLS available
98    #[error("no TLS available")]
99    NoTls,
100    /// Invalid response to resource binding
101    #[error("invalid response to resource binding")]
102    InvalidBindResponse,
103    /// No xmlns attribute in <stream:stream>
104    #[error("no xmlns attribute in <stream:stream>")]
105    NoStreamNamespace,
106    /// No id attribute in <stream:stream>
107    #[error("no id attribute in <stream:stream>")]
108    NoStreamId,
109    /// Encountered an unexpected XML token
110    #[error("encountered an unexpected XML token")]
111    InvalidToken,
112    /// Unexpected <stream:stream> (shouldn't occur)
113    #[error("unexpected <stream:stream>")]
114    InvalidStreamStart,
115}
116
117/// Authentication error
118#[derive(Debug, Error)]
119pub enum AuthError {
120    /// No matching SASL mechanism available
121    #[error("no matching SASL mechanism available")]
122    NoMechanism,
123    /// Local SASL implementation error
124    #[error("local SASL implementation error: {0}")]
125    Sasl(SaslMechanismError),
126    /// Failure from server
127    #[error("failure from the server: {0:?}")]
128    Fail(SaslDefinedCondition),
129    /// Component authentication failure
130    #[error("component authentication failure")]
131    ComponentFail,
132}
tokio_xmpp/error.rs

tokio_xmpp/
error.rs
