tmdb_api/tvshow/season/
details.rs

1pub type Params<'a> = crate::common::LanguageParams<'a>;
2
3impl<E: crate::client::Executor> crate::Client<E> {
4    /// Get tvshow season 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_season_details(
20        &self,
21        tvshow_id: u64,
22        season_number: u64,
23        params: &Params<'_>,
24    ) -> crate::Result<crate::tvshow::Season> {
25        let url = format!("/tv/{tvshow_id}/season/{season_number}");
26        self.execute(&url, params).await
27    }
28}
29
30#[cfg(test)]
31mod tests {
32    use mockito::Matcher;
33
34    use crate::client::Client;
35    use crate::client::reqwest::ReqwestExecutor;
36
37    #[tokio::test]
38    async fn it_works() {
39        let mut server = mockito::Server::new_async().await;
40        let client = Client::<ReqwestExecutor>::builder()
41            .with_api_key("secret".into())
42            .with_base_url(server.url())
43            .build()
44            .unwrap();
45
46        let _m = server
47            .mock("GET", "/tv/1399/season/1")
48            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
49            .with_status(200)
50            .with_header("content-type", "application/json")
51            .with_body(include_str!("../../../assets/tv-season-details.json"))
52            .create_async()
53            .await;
54
55        let result = client
56            .get_tvshow_season_details(1399, 1, &Default::default())
57            .await
58            .unwrap();
59        assert_eq!(result.inner.id, 3624);
60    }
61
62    #[tokio::test]
63    async fn invalid_api_key() {
64        let mut server = mockito::Server::new_async().await;
65        let client = Client::<ReqwestExecutor>::builder()
66            .with_api_key("secret".into())
67            .with_base_url(server.url())
68            .build()
69            .unwrap();
70
71        let _m = server
72            .mock("GET", "/tv/1399/season/1")
73            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
74            .with_status(401)
75            .with_header("content-type", "application/json")
76            .with_body(include_str!("../../../assets/invalid-api-key.json"))
77            .create_async()
78            .await;
79
80        let err = client
81            .get_tvshow_season_details(1399, 1, &Default::default())
82            .await
83            .unwrap_err();
84        let server_err = err.as_server_error().unwrap();
85        assert_eq!(server_err.status_code, 7);
86    }
87
88    #[tokio::test]
89    async fn resource_not_found() {
90        let mut server = mockito::Server::new_async().await;
91        let client = Client::<ReqwestExecutor>::builder()
92            .with_api_key("secret".into())
93            .with_base_url(server.url())
94            .build()
95            .unwrap();
96
97        let _m = server
98            .mock("GET", "/tv/1399/season/1")
99            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
100            .with_status(404)
101            .with_header("content-type", "application/json")
102            .with_body(include_str!("../../../assets/resource-not-found.json"))
103            .create_async()
104            .await;
105
106        let err = client
107            .get_tvshow_season_details(1399, 1, &Default::default())
108            .await
109            .unwrap_err();
110        let server_err = err.as_server_error().unwrap();
111        assert_eq!(server_err.status_code, 34);
112    }
113}
114
115#[cfg(all(test, feature = "integration"))]
116mod integration_tests {
117    use crate::client::Client;
118    use crate::client::reqwest::ReqwestExecutor;
119
120    #[tokio::test]
121    async fn execute() {
122        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
123        let client = Client::<ReqwestExecutor>::new(secret);
124
125        for (tv_id, season_id) in [(1, 1), (2328126u64, 1)] {
126            let result = client
127                .get_tvshow_season_details(tv_id, season_id, &Default::default())
128                .await
129                .unwrap();
130            assert_eq!(result.inner.id, season_id);
131        }
132    }
133}
tmdb_api/tvshow/season/details.rs

tmdb_api/tvshow/season/
details.rs
