oauth2-twitter 0.2.0

OAuth 2.0 Twitter
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

// [Users lookup](https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-me)

use oauth2_client::re_exports::{
    http::header::{ACCEPT, AUTHORIZATION},
    serde_json, thiserror, Body, Deserialize, Endpoint, HttpError, Request, Response,
    SerdeJsonError, Serialize, Url, UrlParseError, MIME_APPLICATION_JSON,
};

pub const URL: &str = "https://api.twitter.com/2/users/me";

//
#[derive(Debug, Clone)]
pub struct UsersMeEndpoint {
    access_token: String,
}
impl UsersMeEndpoint {
    pub fn new(access_token: impl AsRef<str>) -> Self {
        Self {
            access_token: access_token.as_ref().to_owned(),
        }
    }
}

impl Endpoint for UsersMeEndpoint {
    type RenderRequestError = UsersMeEndpointError;

    type ParseResponseOutput = User;
    type ParseResponseError = UsersMeEndpointError;

    fn render_request(&self) -> Result<Request<Body>, Self::RenderRequestError> {
        let mut url = Url::parse(URL).map_err(UsersMeEndpointError::UrlParseFailed)?;
        url.query_pairs_mut()
            .append_pair("user.fields", "id,name,username,created_at,description");

        let request = Request::builder()
            .uri(url.as_str())
            .header(AUTHORIZATION, format!("Bearer {}", &self.access_token))
            .header(ACCEPT, MIME_APPLICATION_JSON)
            .body(vec![])
            .map_err(UsersMeEndpointError::MakeRequestFailed)?;

        Ok(request)
    }

    fn parse_response(
        &self,
        response: Response<Body>,
    ) -> Result<Self::ParseResponseOutput, Self::ParseResponseError> {
        if response.status().is_success() {
            let body = serde_json::from_slice::<ResponseOkBody>(response.body())
                .map_err(UsersMeEndpointError::DeResponseBodyFailed)?;

            Ok(body.data)
        } else {
            let body = serde_json::from_slice::<ResponseFailBody>(response.body())
                .map_err(UsersMeEndpointError::DeResponseBodyFailed)?;

            Err(UsersMeEndpointError::ResponseBodyIsFail(body))
        }
    }
}

#[derive(Deserialize, Serialize, Debug, Clone)]
pub struct ResponseOkBody {
    pub data: User,
}

#[derive(Deserialize, Serialize, Debug, Clone)]
pub struct User {
    pub id: String,
    pub name: String,
    pub username: String,
    pub created_at: Option<String>,
    pub description: Option<String>,
}

#[derive(Deserialize, Serialize, Debug, Clone)]
pub struct ResponseFailBody {
    pub title: String,
    pub r#type: String,
    pub status: usize,
    pub detail: String,
}

impl core::fmt::Display for ResponseFailBody {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        write!(f, "{self:?}")
    }
}
impl std::error::Error for ResponseFailBody {}

#[derive(thiserror::Error, Debug)]
pub enum UsersMeEndpointError {
    #[error("UrlParseFailed {0}")]
    UrlParseFailed(UrlParseError),
    //
    #[error("MakeRequestFailed {0}")]
    MakeRequestFailed(HttpError),
    //
    #[error("DeResponseBodyFailed {0}")]
    DeResponseBodyFailed(SerdeJsonError),
    //
    #[error("ResponseBodyIsFail {0:?}")]
    ResponseBodyIsFail(ResponseFailBody),
}

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

    #[test]
    fn de_response_body() {
        match serde_json::from_str::<ResponseOkBody>(include_str!(
            "../../tests/response_body_json_files/users_me.json"
        )) {
            Ok(body) => {
                assert_eq!(body.data.name, "HAWE");
            }
            Err(err) => panic!("{err}"),
        }

        match serde_json::from_str::<ResponseFailBody>(include_str!(
            "../../tests/response_body_json_files/users_me_fail.json"
        )) {
            Ok(_) => {}
            Err(err) => panic!("{err}"),
        }
    }
}