pushover 0.4.0

A wrapper for the Pushover API.
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

use reqwest::Method;
use url::Url;

use crate::requests::base::{add_optional_param, RawBasicResponse, Request};
use crate::types::User;

/// Add a user to a group
///
/// Return type is `String` which is the request parameter (https://pushover.net/api#response).
#[derive(Clone, Debug, PartialEq, PartialOrd)]
pub struct AddUser {
    pub token: String,
    pub group_key: String,
    pub user: User,
}

impl AddUser {
    pub fn new<R, T>(token: T, group_key: R, user: &User) -> Self
    where
        R: Into<String>,
        T: Into<String>,
    {
        Self {
            token: token.into(),
            group_key: group_key.into(),
            user: user.clone(),
        }
    }
}

impl Request for AddUser {
    type ResponseType = String;
    type RawResponseType = RawBasicResponse;

    fn build_url(&self, url: &mut Url) {
        url.path_segments_mut()
            .unwrap()
            .push("groups")
            .push(&self.group_key)
            .push("add_user.json");

        let mut params = url.query_pairs_mut();
        params.append_pair("token", &self.token);
        params.append_pair("user", &self.user.user);
        add_optional_param(&mut params, "device", &self.user.device);
        add_optional_param(&mut params, "memo", &self.user.memo);
    }

    fn get_method(&self) -> Method {
        Method::POST
    }

    fn map(raw: Self::RawResponseType) -> Self::ResponseType {
        raw.request
    }
}

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

    #[test]
    fn get_url_with_all_fields() {
        let mut user = User::new("user_key");
        user.set_device("device name");
        user.set_memo("memo name");

        let req = AddUser::new("add_token", "add_group_key", &user);

        assert_req_url(
            &req,
            &format!("groups/{}/add_user.json", req.group_key),
            Some(&[
                ("token", &req.token),
                ("user", &req.user.user),
                ("device", req.user.device.as_ref().unwrap()),
                ("memo", req.user.memo.as_ref().unwrap()),
            ]),
        );
    }

    #[test]
    fn get_url_with_mandatory_fields() {
        let user = User::new("user_key");

        let req = AddUser::new("add_token", "add_group_key", &user);

        assert_req_url(
            &req,
            &format!("groups/{}/add_user.json", req.group_key),
            Some(&[("token", &req.token), ("user", &req.user.user)]),
        );
    }
}