tmdb_api/tvshow/
details.rs

1pub type Params<'a> = crate::common::LanguageParams<'a>;
2
3impl<E: crate::client::Executor> crate::Client<E> {
4    /// Get tvshow details
5    ///
6    /// ```rust
7    /// use tmdb_api::client::Client;
8    /// use tmdb_api::client::reqwest::Client as ReqwestClient;
9    ///
10    /// #[tokio::main]
11    /// async fn main() {
12    ///     let client = Client::<ReqwestClient>::new("this-is-my-secret-token".into());
13    ///     match client.get_tvshow_details(42, &Default::default()).await {
14    ///         Ok(res) => println!("found: {:#?}", res),
15    ///         Err(err) => eprintln!("error: {:?}", err),
16    ///     };
17    /// }
18    /// ```
19    pub async fn get_tvshow_details(
20        &self,
21        tvshow_id: u64,
22        params: &Params<'_>,
23    ) -> crate::Result<super::TVShow> {
24        let url = format!("/tv/{tvshow_id}");
25        self.execute(&url, params).await
26    }
27}
28
29#[cfg(test)]
30mod tests {
31    use mockito::Matcher;
32
33    use crate::client::Client;
34    use crate::client::reqwest::Client as ReqwestClient;
35
36    #[tokio::test]
37    async fn it_works() {
38        let mut server = mockito::Server::new_async().await;
39        let client = Client::<ReqwestClient>::builder()
40            .with_api_key("secret".into())
41            .with_base_url(server.url())
42            .build()
43            .unwrap();
44
45        let _m = server
46            .mock("GET", "/tv/1399")
47            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
48            .with_status(200)
49            .with_header("content-type", "application/json")
50            .with_body(include_str!("../../assets/tv-details.json"))
51            .create_async()
52            .await;
53
54        let result = client
55            .get_tvshow_details(1399, &Default::default())
56            .await
57            .unwrap();
58        assert_eq!(result.inner.id, 1399);
59    }
60
61    #[tokio::test]
62    async fn complex_works() {
63        let mut server = mockito::Server::new_async().await;
64        let client = Client::<ReqwestClient>::builder()
65            .with_api_key("secret".into())
66            .with_base_url(server.url())
67            .build()
68            .unwrap();
69
70        let _m = server
71            .mock("GET", "/tv/2")
72            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
73            .with_status(200)
74            .with_header("content-type", "application/json")
75            .with_body(include_str!("../../assets/tv-details-complex.json"))
76            .create_async()
77            .await;
78
79        let result = client
80            .get_tvshow_details(2, &Default::default())
81            .await
82            .unwrap();
83        assert_eq!(result.inner.id, 2);
84    }
85
86    #[tokio::test]
87    async fn invalid_api_key() {
88        let mut server = mockito::Server::new_async().await;
89        let client = Client::<ReqwestClient>::builder()
90            .with_api_key("secret".into())
91            .with_base_url(server.url())
92            .build()
93            .unwrap();
94
95        let _m = server
96            .mock("GET", "/tv/1399")
97            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
98            .with_status(401)
99            .with_header("content-type", "application/json")
100            .with_body(include_str!("../../assets/invalid-api-key.json"))
101            .create_async()
102            .await;
103
104        let err = client
105            .get_tvshow_details(1399, &Default::default())
106            .await
107            .unwrap_err();
108        let server_err = err.as_server_error().unwrap();
109        assert_eq!(server_err.status_code, 7);
110    }
111
112    #[tokio::test]
113    async fn resource_not_found() {
114        let mut server = mockito::Server::new_async().await;
115        let client = Client::<ReqwestClient>::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(404)
125            .with_header("content-type", "application/json")
126            .with_body(include_str!("../../assets/resource-not-found.json"))
127            .create_async()
128            .await;
129
130        let err = client
131            .get_tvshow_details(1399, &Default::default())
132            .await
133            .unwrap_err();
134        let server_err = err.as_server_error().unwrap();
135        assert_eq!(server_err.status_code, 34);
136    }
137}
138
139#[cfg(all(test, feature = "integration"))]
140mod integration_tests {
141    use crate::client::Client;
142    use crate::client::reqwest::Client as ReqwestClient;
143
144    #[tokio::test]
145    async fn execute() {
146        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
147        let client = Client::<ReqwestClient>::new(secret);
148
149        for i in [1, 2, 3, 4, 5, 81040] {
150            let result = client
151                .get_tvshow_details(i, &Default::default())
152                .await
153                .unwrap();
154            assert_eq!(result.inner.id, i);
155        }
156    }
157}
tmdb_api/tvshow/details.rs

tmdb_api/tvshow/
details.rs
