oauth1-twitter 0.2.1

Twitter OAuth 1.0a
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

//! https://developer.twitter.com/en/docs/authentication/api-reference/authenticate

use http_api_client_endpoint::{http::Method, Body, Endpoint, Request, Response};
use url::Url;

pub const URL: &str = "https://api.twitter.com/oauth/authenticate";

//
#[derive(Debug, Clone)]
pub struct AuthenticateEndpoint {
    pub oauth_token: String,
    pub force_login: Option<bool>,
    pub screen_name: Option<String>,
}
impl AuthenticateEndpoint {
    pub fn new(oauth_token: impl AsRef<str>) -> Self {
        Self {
            oauth_token: oauth_token.as_ref().into(),
            force_login: None,
            screen_name: None,
        }
    }

    pub fn with_force_login(mut self, force_login: bool) -> Self {
        self.force_login = Some(force_login);
        self
    }

    pub fn with_screen_name(mut self, screen_name: impl AsRef<str>) -> Self {
        self.screen_name = Some(screen_name.as_ref().into());
        self
    }

    pub fn authorization_url(&self) -> Result<String, AuthenticateEndpointError> {
        let request = self.render_request()?;
        Ok(request.uri().to_string())
    }
}

impl Endpoint for AuthenticateEndpoint {
    type RenderRequestError = AuthenticateEndpointError;

    type ParseResponseOutput = ();
    type ParseResponseError = AuthenticateEndpointError;

    fn render_request(&self) -> Result<Request<Body>, Self::RenderRequestError> {
        let mut url = Url::parse(URL).map_err(AuthenticateEndpointError::MakeRequestUrlFailed)?;

        let query = AuthenticateRequestQuery {
            oauth_token: self.oauth_token.to_owned(),
            force_login: self.force_login,
            screen_name: self.screen_name.to_owned(),
        };

        let query = serde_qs::to_string(&query)
            .map_err(AuthenticateEndpointError::SerRequestUrlQueryFailed)?;

        url.set_query(Some(query.as_str()));

        let request = Request::builder()
            .method(Method::GET)
            .uri(url.as_str())
            .body(vec![])
            .map_err(AuthenticateEndpointError::MakeRequestFailed)?;

        Ok(request)
    }

    fn parse_response(
        &self,
        _response: Response<Body>,
    ) -> Result<Self::ParseResponseOutput, Self::ParseResponseError> {
        unreachable!()
    }
}

//
pub type AuthenticateRequestQuery = crate::endpoints::authorize::AuthorizeRequestQuery;

//
//
//
pub type AuthenticateEndpointError = crate::endpoints::authorize::AuthorizeEndpointError;

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

    #[test]
    fn test_render_request() {
        //
        let req = AuthenticateEndpoint::new("Z6eEdO8MOmk394WozF5oKyuAv855l4Mlqo7hxxxxxx")
            .render_request()
            .unwrap();
        assert_eq!(req.method(), Method::GET);
        assert_eq!(req.uri(), "https://api.twitter.com/oauth/authenticate?oauth_token=Z6eEdO8MOmk394WozF5oKyuAv855l4Mlqo7hxxxxxx");

        //
        let req = AuthenticateEndpoint::new("Z6eEdO8MOmk394WozF5oKyuAv855l4Mlqo7hxxxxxx")
            .with_force_login(true)
            .with_screen_name("xxx")
            .render_request()
            .unwrap();
        assert_eq!(req.method(), Method::GET);
        assert_eq!(req.uri(), "https://api.twitter.com/oauth/authenticate?oauth_token=Z6eEdO8MOmk394WozF5oKyuAv855l4Mlqo7hxxxxxx&force_login=true&screen_name=xxx");
    }
}