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
107
108
109
110
111
112

use reqwest::Method;
use serde::Deserialize;
use url::Url;

use crate::requests::base::{add_optional_param, RawResponse, Request};

/// Verify user/group
///
/// Return type is [VerificationResponse](struct.VerificationResponse.html).
#[derive(Clone, Debug, PartialEq, PartialOrd)]
pub struct Verification {
    pub token: String,
    pub user: String,
    pub device: Option<String>,
}

impl Verification {
    pub fn new<R, T>(token: T, user: R) -> Self
    where
        R: Into<String>,
        T: Into<String>,
    {
        Self {
            token: token.into(),
            user: user.into(),
            device: None,
        }
    }

    pub fn set_device<T: Into<String>>(&mut self, device: T) {
        self.device = Some(device.into());
    }
}

impl Request for Verification {
    type ResponseType = VerificationResponse;
    type RawResponseType = RawVerificationResponse;

    fn build_url(&self, url: &mut Url) {
        url.path_segments_mut()
            .unwrap()
            .push("users")
            .push("validate.json");

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

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

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

#[derive(Clone, Debug, PartialEq, PartialOrd)]
pub struct VerificationResponse {
    pub devices: Vec<String>,
    pub request: String,
}

#[derive(Deserialize)]
pub struct RawVerificationResponse {
    pub status: i32,
    pub request: String,
    pub errors: Option<Vec<String>>,
    pub devices: Option<Vec<String>>,
}

impl RawResponse for RawVerificationResponse {
    raw_response_basic_getters!();
}

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

    #[test]
    fn get_url_with_all_fields() {
        let mut req = Verification::new("ver_token", "ver user");
        req.set_device("ver device");

        assert_req_url(
            &req,
            "users/validate.json",
            Some(&[
                ("token", &req.token),
                ("user", &req.user),
                ("device", &req.device.as_ref().unwrap()),
            ]),
        );
    }

    #[test]
    fn get_url_with_mandatory_fields() {
        let req = Verification::new("ver_token", "ver user");

        assert_req_url(
            &req,
            "users/validate.json",
            Some(&[("token", &req.token), ("user", &req.user)]),
        );
    }
}