tone3000 0.1.0

Async Rust client for the TONE3000 API (v1)
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

//! Strongly-typed identifiers. Tone/model/make/tag ids are integers; user ids are
//! UUID strings. Newtypes prevent accidentally passing one id where another is expected.

use std::fmt;

use serde::{Deserialize, Serialize};

macro_rules! int_id {
    ($(#[$m:meta])* $name:ident) => {
        $(#[$m])*
        #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
        #[serde(transparent)]
        pub struct $name(pub u64);

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

        impl From<u64> for $name {
            fn from(v: u64) -> Self {
                Self(v)
            }
        }
    };
}

int_id!(
    /// Identifier for a [`crate::Tone`].
    ToneId
);
int_id!(
    /// Identifier for a [`crate::Model`].
    ModelId
);
int_id!(
    /// Identifier for a gear make.
    MakeId
);
int_id!(
    /// Identifier for a tag.
    TagId
);

/// Identifier for a user (a UUID string).
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
#[serde(transparent)]
pub struct UserId(pub String);

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

impl From<String> for UserId {
    fn from(v: String) -> Self {
        Self(v)
    }
}

impl From<&str> for UserId {
    fn from(v: &str) -> Self {
        Self(v.to_string())
    }
}

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

    #[test]
    fn int_id_is_transparent() {
        assert_eq!(serde_json::to_string(&ToneId(51949)).unwrap(), "51949");
        let id: ToneId = serde_json::from_str("51949").unwrap();
        assert_eq!(id, ToneId(51949));
        assert_eq!(ToneId(7).to_string(), "7");
        assert_eq!(ToneId::from(7u64), ToneId(7));
    }

    #[test]
    fn user_id_is_transparent_string() {
        let raw = "\"57af4bb9-80fe-43be-93b3-e3c9e9d92717\"";
        let id: UserId = serde_json::from_str(raw).unwrap();
        assert_eq!(id, UserId("57af4bb9-80fe-43be-93b3-e3c9e9d92717".into()));
        assert_eq!(serde_json::to_string(&id).unwrap(), raw);
    }
}