ntfy 0.9.1

Library for sending notifications over ntfy
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
148
149
150
151
152
153
154
155
156
157

// Copyright (c) 2022 Yuki Kishimoto
// Distributed under the MIT software license

use std::fmt;
use std::str::FromStr;

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

use crate::error::Error;

#[repr(u8)]
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum Priority {
    Max = 5,
    High = 4,
    #[default]
    Default = 3,
    Low = 2,
    Min = 1,
}

impl fmt::Display for Priority {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{}", self.as_str())
    }
}

impl Priority {
    pub fn from_u8(priority: u8) -> Result<Self, Error> {
        match priority {
            5 => Ok(Priority::Max),
            4 => Ok(Priority::High),
            3 => Ok(Priority::Default),
            2 => Ok(Priority::Low),
            1 => Ok(Priority::Min),
            _ => Err(Error::UnknownPriority),
        }
    }

    /// Convert to `u8`
    #[inline]
    pub fn as_u8(&self) -> u8 {
        *self as u8
    }

    /// Convert to `&str`
    pub fn as_str(&self) -> &str {
        match self {
            Self::Max => "max",
            Self::High => "high",
            Self::Default => "default",
            Self::Low => "low",
            Self::Min => "min",
        }
    }
}

impl FromStr for Priority {
    type Err = Error;

    fn from_str(priority: &str) -> Result<Self, Self::Err> {
        match priority {
            "max" | "urgent" => Ok(Self::Max),
            "high" => Ok(Self::High),
            "default" => Ok(Self::Default),
            "low" => Ok(Self::Low),
            "min" => Ok(Self::Min),
            _ => Err(Error::UnknownPriority),
        }
    }
}

#[derive(Deserialize)]
#[serde(untagged)]
enum NumberOrString {
    Number(u8),
    String(String),
}

impl Serialize for Priority {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        // According to ntfy docs, the priority in the JSON payload must be a number.
        // https://docs.ntfy.sh/subscribe/api/#json-message-format
        serializer.serialize_u8(self.as_u8())
    }
}

impl<'de> Deserialize<'de> for Priority {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        match NumberOrString::deserialize(deserializer)? {
            NumberOrString::Number(priority) => {
                Priority::from_u8(priority).map_err(de::Error::custom)
            }
            NumberOrString::String(priority) => {
                Self::from_str(&priority).map_err(de::Error::custom)
            }
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_deserialize() {
        let json = serde_json::json!(5);
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Max);

        let json = serde_json::json!(4);
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::High);

        let json = serde_json::json!(3);
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Default);

        let json = serde_json::json!(2);
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Low);

        let json = serde_json::json!(1);
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Min);

        let json = serde_json::json!("urgent");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Max);

        let json = serde_json::json!("max");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Max);

        let json = serde_json::json!("high");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::High);

        let json = serde_json::json!("default");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Default);

        let json = serde_json::json!("low");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Low);

        let json = serde_json::json!("min");
        let priority: Priority = serde_json::from_value(json).unwrap();
        assert_eq!(priority, Priority::Min);
    }
}