tmdb_api/tvshow/
details.rs

1use std::borrow::Cow;
2
3/// Command to get the details of a tvshow
4///
5/// ```rust
6/// use tmdb_api::prelude::Command;
7/// use tmdb_api::client::Client;
8/// use tmdb_api::client::reqwest::ReqwestExecutor;
9/// use tmdb_api::tvshow::details::TVShowDetails;
10///
11/// #[tokio::main]
12/// async fn main() {
13///     let client = Client::<ReqwestExecutor>::new("this-is-my-secret-token".into());
14///     let cmd = TVShowDetails::new(1);
15///     let result = cmd.execute(&client).await;
16///     match result {
17///         Ok(res) => println!("found: {:#?}", res),
18///         Err(err) => eprintln!("error: {:?}", err),
19///     };
20/// }
21/// ```
22#[derive(Clone, Debug, Default)]
23pub struct TVShowDetails {
24    /// ID of the TV Show
25    pub tv_id: u64,
26    /// ISO 639-1 value to display translated data for the fields that support it.
27    pub language: Option<String>,
28}
29
30impl TVShowDetails {
31    pub fn new(tv_id: u64) -> Self {
32        Self {
33            tv_id,
34            language: None,
35        }
36    }
37
38    pub fn with_language(mut self, value: Option<String>) -> Self {
39        self.language = value;
40        self
41    }
42}
43
44impl crate::prelude::Command for TVShowDetails {
45    type Output = super::TVShow;
46
47    fn path(&self) -> Cow<'static, str> {
48        Cow::Owned(format!("/tv/{}", self.tv_id))
49    }
50
51    fn params(&self) -> Vec<(&'static str, Cow<'_, str>)> {
52        if let Some(language) = self.language.as_ref() {
53            vec![("language", Cow::Borrowed(language.as_str()))]
54        } else {
55            Vec::new()
56        }
57    }
58}
59
60#[cfg(test)]
61mod tests {
62    use super::TVShowDetails;
63    use crate::client::Client;
64    use crate::client::reqwest::ReqwestExecutor;
65    use crate::prelude::Command;
66    use mockito::Matcher;
67
68    #[tokio::test]
69    async fn it_works() {
70        let mut server = mockito::Server::new_async().await;
71        let client = Client::<ReqwestExecutor>::builder()
72            .with_api_key("secret".into())
73            .with_base_url(server.url())
74            .build()
75            .unwrap();
76
77        let _m = server
78            .mock("GET", "/tv/1399")
79            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
80            .with_status(200)
81            .with_header("content-type", "application/json")
82            .with_body(include_str!("../../assets/tv-details.json"))
83            .create_async()
84            .await;
85
86        let result = TVShowDetails::new(1399).execute(&client).await.unwrap();
87        assert_eq!(result.inner.id, 1399);
88    }
89
90    #[tokio::test]
91    async fn complex_works() {
92        let mut server = mockito::Server::new_async().await;
93        let client = Client::<ReqwestExecutor>::builder()
94            .with_api_key("secret".into())
95            .with_base_url(server.url())
96            .build()
97            .unwrap();
98
99        let _m = server
100            .mock("GET", "/tv/2")
101            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
102            .with_status(200)
103            .with_header("content-type", "application/json")
104            .with_body(include_str!("../../assets/tv-details-complex.json"))
105            .create_async()
106            .await;
107
108        let result = TVShowDetails::new(2).execute(&client).await.unwrap();
109        assert_eq!(result.inner.id, 2);
110    }
111
112    #[tokio::test]
113    async fn invalid_api_key() {
114        let mut server = mockito::Server::new_async().await;
115        let client = Client::<ReqwestExecutor>::builder()
116            .with_api_key("secret".into())
117            .with_base_url(server.url())
118            .build()
119            .unwrap();
120
121        let _m = server
122            .mock("GET", "/tv/1399")
123            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
124            .with_status(401)
125            .with_header("content-type", "application/json")
126            .with_body(include_str!("../../assets/invalid-api-key.json"))
127            .create_async()
128            .await;
129
130        let err = TVShowDetails::new(1399).execute(&client).await.unwrap_err();
131        let server_err = err.as_server_error().unwrap();
132        assert_eq!(server_err.status_code, 7);
133    }
134
135    #[tokio::test]
136    async fn resource_not_found() {
137        let mut server = mockito::Server::new_async().await;
138        let client = Client::<ReqwestExecutor>::builder()
139            .with_api_key("secret".into())
140            .with_base_url(server.url())
141            .build()
142            .unwrap();
143
144        let _m = server
145            .mock("GET", "/tv/1399")
146            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
147            .with_status(404)
148            .with_header("content-type", "application/json")
149            .with_body(include_str!("../../assets/resource-not-found.json"))
150            .create_async()
151            .await;
152
153        let err = TVShowDetails::new(1399).execute(&client).await.unwrap_err();
154        let server_err = err.as_server_error().unwrap();
155        assert_eq!(server_err.status_code, 34);
156    }
157}
158
159#[cfg(all(test, feature = "integration"))]
160mod integration_tests {
161    use super::TVShowDetails;
162    use crate::client::Client;
163    use crate::client::reqwest::ReqwestExecutor;
164    use crate::prelude::Command;
165
166    #[tokio::test]
167    async fn execute() {
168        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
169        let client = Client::<ReqwestExecutor>::new(secret);
170
171        for i in [1, 2, 3, 4, 5, 81040] {
172            let result = TVShowDetails::new(i).execute(&client).await.unwrap();
173            assert_eq!(result.inner.id, i);
174        }
175    }
176}
tmdb_api/tvshow/details.rs

tmdb_api/tvshow/
details.rs
