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
96
97
98
99
100
101
102
103
104
105
106

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

use crate::requests::base::{add_optional_param, Request};
use crate::requests::license::check_credits::{CheckCreditsResponse, RawCheckCreditsResponse};
use crate::types::{OperatingSystem, UserType};

/// Assign a license
///
/// Return type is [CheckCreditsResponse](struct.CheckCreditsResponse.html).
#[derive(Clone, Debug, PartialEq, PartialOrd)]
pub struct Assign {
    pub token: String,
    pub os: Option<OperatingSystem>,
    pub user_type: UserType,
}

impl Assign {
    pub fn new<T>(token: T, user_type: UserType) -> Self
    where
        T: Into<String>,
    {
        Self {
            token: token.into(),
            os: None,
            user_type: user_type,
        }
    }

    pub fn set_os(&mut self, os: OperatingSystem) {
        self.os = Some(os);
    }
}

impl Request for Assign {
    type ResponseType = CheckCreditsResponse;
    type RawResponseType = RawCheckCreditsResponse;

    fn build_url(&self, url: &mut Url) {
        url.path_segments_mut()
            .unwrap()
            .push("licenses")
            .push("assign.json");
        let mut params = url.query_pairs_mut();

        params.append_pair("token", &self.token);

        match self.user_type {
            UserType::Email(ref email) => {
                params.append_pair("email", email);
            }
            UserType::UserKey(ref key) => {
                params.append_pair("user", key);
            }
        }

        add_optional_param(&mut params, "os", &self.os);
    }

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

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

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

    #[test]
    fn get_url_with_all_fields() {
        let mut req = Assign::new(
            "assign_token",
            UserType::Email(String::from("email@email.com")),
        );
        req.set_os(OperatingSystem::iOS);

        assert_req_url(
            &req,
            "licenses/assign.json",
            Some(&[
                ("token", &req.token),
                ("email", "email@email.com"),
                ("os", &req.os.as_ref().unwrap().to_string()),
            ]),
        );
    }

    #[test]
    fn get_url_with_mandatory_fields() {
        let req = Assign::new("assign_token", UserType::UserKey(String::from("user_key")));

        assert_req_url(
            &req,
            "licenses/assign.json",
            Some(&[("token", &req.token), ("user", "user_key")]),
        );
    }
}