ruststream-rumqttc 0.6.0

MQTT 5 broker implementation for the RustStream messaging framework, built on rumqttc.
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

//! The crate-level error type.

use std::error::Error as StdError;

/// Errors returned by the MQTT 5 broker.
///
/// One enum for the whole crate, variants by source, per the `RustStream` broker conventions.
/// The wrapped sources are boxed `std` errors so the public API does not leak the client's
/// error types.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum MqttError {
    /// Establishing the connection failed (transport, TLS, or the broker refused the
    /// connection with a non-retryable reason).
    #[error("mqtt connection error: {0}")]
    Connect(#[source] Box<dyn StdError + Send + Sync>),

    /// Subscribing failed (the broker rejected the filter, or the connection died).
    #[error("mqtt subscribe error on '{filter}': {reason}")]
    Subscribe {
        /// The topic filter the subscription targeted.
        filter: String,
        /// The rejection or transport reason.
        reason: String,
    },

    /// The connection failed permanently while receiving.
    #[error("mqtt receive error: {0}")]
    Receive(String),

    /// Publishing failed (the connection task is gone, or the topic is invalid).
    #[error("mqtt publish error to '{topic}': {reason}")]
    Publish {
        /// The topic the message targeted.
        topic: String,
        /// The failure reason.
        reason: String,
    },

    /// The handle is used before `connect` filled the shared connection, or after `shutdown`.
    #[error("mqtt broker is not connected")]
    NotConnected,

    /// A broker option or subscription descriptor is invalid.
    #[error("invalid mqtt descriptor: {0}")]
    Invalid(String),
}