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::ReqwestExecutor;
9    ///
10    /// #[tokio::main]
11    /// async fn main() {
12    ///     let client = Client::<ReqwestExecutor>::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 crate::client::Client;
32    use crate::client::reqwest::ReqwestExecutor;
33    use mockito::Matcher;
34
35    #[tokio::test]
36    async fn it_works() {
37        let mut server = mockito::Server::new_async().await;
38        let client = Client::<ReqwestExecutor>::builder()
39            .with_api_key("secret".into())
40            .with_base_url(server.url())
41            .build()
42            .unwrap();
43
44        let _m = server
45            .mock("GET", "/tv/1399")
46            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
47            .with_status(200)
48            .with_header("content-type", "application/json")
49            .with_body(include_str!("../../assets/tv-details.json"))
50            .create_async()
51            .await;
52
53        let result = client
54            .get_tvshow_details(1399, &Default::default())
55            .await
56            .unwrap();
57        assert_eq!(result.inner.id, 1399);
58    }
59
60    #[tokio::test]
61    async fn complex_works() {
62        let mut server = mockito::Server::new_async().await;
63        let client = Client::<ReqwestExecutor>::builder()
64            .with_api_key("secret".into())
65            .with_base_url(server.url())
66            .build()
67            .unwrap();
68
69        let _m = server
70            .mock("GET", "/tv/2")
71            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
72            .with_status(200)
73            .with_header("content-type", "application/json")
74            .with_body(include_str!("../../assets/tv-details-complex.json"))
75            .create_async()
76            .await;
77
78        let result = client
79            .get_tvshow_details(2, &Default::default())
80            .await
81            .unwrap();
82        assert_eq!(result.inner.id, 2);
83    }
84
85    #[tokio::test]
86    async fn invalid_api_key() {
87        let mut server = mockito::Server::new_async().await;
88        let client = Client::<ReqwestExecutor>::builder()
89            .with_api_key("secret".into())
90            .with_base_url(server.url())
91            .build()
92            .unwrap();
93
94        let _m = server
95            .mock("GET", "/tv/1399")
96            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
97            .with_status(401)
98            .with_header("content-type", "application/json")
99            .with_body(include_str!("../../assets/invalid-api-key.json"))
100            .create_async()
101            .await;
102
103        let err = client
104            .get_tvshow_details(1399, &Default::default())
105            .await
106            .unwrap_err();
107        let server_err = err.as_server_error().unwrap();
108        assert_eq!(server_err.status_code, 7);
109    }
110
111    #[tokio::test]
112    async fn resource_not_found() {
113        let mut server = mockito::Server::new_async().await;
114        let client = Client::<ReqwestExecutor>::builder()
115            .with_api_key("secret".into())
116            .with_base_url(server.url())
117            .build()
118            .unwrap();
119
120        let _m = server
121            .mock("GET", "/tv/1399")
122            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
123            .with_status(404)
124            .with_header("content-type", "application/json")
125            .with_body(include_str!("../../assets/resource-not-found.json"))
126            .create_async()
127            .await;
128
129        let err = client
130            .get_tvshow_details(1399, &Default::default())
131            .await
132            .unwrap_err();
133        let server_err = err.as_server_error().unwrap();
134        assert_eq!(server_err.status_code, 34);
135    }
136}
137
138#[cfg(all(test, feature = "integration"))]
139mod integration_tests {
140    use crate::client::Client;
141    use crate::client::reqwest::ReqwestExecutor;
142
143    #[tokio::test]
144    async fn execute() {
145        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
146        let client = Client::<ReqwestExecutor>::new(secret);
147
148        for i in [1, 2, 3, 4, 5, 81040] {
149            let result = client
150                .get_tvshow_details(i, &Default::default())
151                .await
152                .unwrap();
153            assert_eq!(result.inner.id, i);
154        }
155    }
156}
tmdb_api/tvshow/details.rs

tmdb_api/tvshow/
details.rs
