rmqtt-sys-topic 0.1.1

RMQTT periodically publishes its own operational status, message statistics, and client online/offline events to system topics starting with $SYS/.
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

use std::time::Duration;

use serde::{
    de::{self, Deserializer},
    Deserialize, Serialize,
};

use rmqtt::{
    types::QoS,
    utils::{deserialize_duration, to_duration},
    Result,
};

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct PluginConfig {
    #[serde(
        default = "PluginConfig::publish_qos_default",
        deserialize_with = "PluginConfig::deserialize_publish_qos"
    )]
    pub publish_qos: QoS,

    #[serde(
        default = "PluginConfig::publish_interval_default",
        deserialize_with = "PluginConfig::deserialize_publish_interval"
    )]
    pub publish_interval: Duration,

    #[serde(default = "PluginConfig::message_retain_available_default")]
    pub message_retain_available: bool,

    #[serde(
        default = "PluginConfig::message_expiry_interval_default",
        deserialize_with = "deserialize_duration"
    )]
    pub message_expiry_interval: Duration,
}

impl PluginConfig {
    #[inline]
    fn publish_qos_default() -> QoS {
        QoS::AtLeastOnce
    }

    #[inline]
    fn publish_interval_default() -> Duration {
        Duration::from_secs(60)
    }

    #[inline]
    fn message_retain_available_default() -> bool {
        false
    }

    #[inline]
    fn message_expiry_interval_default() -> Duration {
        Duration::from_secs(300)
    }

    #[inline]
    pub fn to_json(&self) -> Result<serde_json::Value> {
        Ok(serde_json::to_value(self)?)
    }

    #[inline]
    fn deserialize_publish_qos<'de, D>(deserializer: D) -> std::result::Result<QoS, D::Error>
    where
        D: Deserializer<'de>,
    {
        let qos = match u8::deserialize(deserializer)? {
            0 => QoS::AtMostOnce,
            1 => QoS::AtLeastOnce,
            2 => QoS::ExactlyOnce,
            _ => return Err(de::Error::custom("QoS configuration error, only values (0,1,2) are supported")),
        };
        Ok(qos)
    }

    #[inline]
    pub fn deserialize_publish_interval<'de, D>(deserializer: D) -> std::result::Result<Duration, D::Error>
    where
        D: Deserializer<'de>,
    {
        let v = String::deserialize(deserializer)?;
        let d = to_duration(&v);
        if d < Duration::from_secs(1) {
            Err(de::Error::custom("'publish_interval' must be greater than 1 second"))
        } else {
            Ok(d)
        }
    }
}