tmdb_api/tvshow/
popular.rs

1use std::borrow::Cow;
2
3use crate::common::PaginatedResult;
4
5/// Get a list of the current popular movies on TMDB. This list updates daily.
6///
7/// ```rust
8/// use tmdb_api::prelude::Command;
9/// use tmdb_api::client::Client;
10/// use tmdb_api::client::reqwest::ReqwestExecutor;
11/// use tmdb_api::tvshow::popular::TVShowPopular;
12///
13/// #[tokio::main]
14/// async fn main() {
15///     let client = Client::<ReqwestExecutor>::new("this-is-my-secret-token".into());
16///     let result = TVShowPopular::default().execute(&client).await;
17///     match result {
18///         Ok(res) => println!("found: {:#?}", res),
19///         Err(err) => eprintln!("error: {:?}", err),
20///     };
21/// }
22/// ```
23#[derive(Clone, Debug, Default)]
24pub struct TVShowPopular {
25    /// ISO 639-1 value to display translated data for the fields that support it.
26    pub language: Option<String>,
27    /// Specify which page to query.
28    pub page: Option<u32>,
29}
30
31impl TVShowPopular {
32    pub fn with_language(mut self, value: Option<String>) -> Self {
33        self.language = value;
34        self
35    }
36
37    pub fn with_page(mut self, value: Option<u32>) -> Self {
38        self.page = value;
39        self
40    }
41}
42
43impl crate::prelude::Command for TVShowPopular {
44    type Output = PaginatedResult<super::TVShowShort>;
45
46    fn path(&self) -> Cow<'static, str> {
47        Cow::Borrowed("/tv/popular")
48    }
49
50    fn params(&self) -> Vec<(&'static str, Cow<'_, str>)> {
51        let mut res = Vec::new();
52        if let Some(ref language) = self.language {
53            res.push(("language", Cow::Borrowed(language.as_str())))
54        }
55        if let Some(ref page) = self.page {
56            res.push(("page", Cow::Owned(page.to_string())))
57        }
58        res
59    }
60}
61
62#[cfg(test)]
63mod tests {
64    use super::TVShowPopular;
65    use crate::client::Client;
66    use crate::client::reqwest::ReqwestExecutor;
67    use crate::prelude::Command;
68    use mockito::Matcher;
69
70    #[tokio::test]
71    async fn it_works() {
72        let mut server = mockito::Server::new_async().await;
73        let client = Client::<ReqwestExecutor>::builder()
74            .with_api_key("secret".into())
75            .with_base_url(server.url())
76            .build()
77            .unwrap();
78
79        let _m = server
80            .mock("GET", "/tv/popular")
81            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
82            .with_status(200)
83            .with_header("content-type", "application/json")
84            .with_body(include_str!("../../assets/tv-popular.json"))
85            .create_async()
86            .await;
87
88        let result = TVShowPopular::default().execute(&client).await.unwrap();
89        assert_eq!(result.page, 1);
90    }
91
92    #[tokio::test]
93    async fn invalid_api_key() {
94        let mut server = mockito::Server::new_async().await;
95        let client = Client::<ReqwestExecutor>::builder()
96            .with_api_key("secret".into())
97            .with_base_url(server.url())
98            .build()
99            .unwrap();
100
101        let _m = server
102            .mock("GET", "/tv/popular")
103            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
104            .with_status(401)
105            .with_header("content-type", "application/json")
106            .with_body(include_str!("../../assets/invalid-api-key.json"))
107            .create_async()
108            .await;
109
110        let err = TVShowPopular::default().execute(&client).await.unwrap_err();
111        let server_err = err.as_server_error().unwrap();
112        assert_eq!(server_err.status_code, 7);
113    }
114
115    #[tokio::test]
116    async fn resource_not_found() {
117        let mut server = mockito::Server::new_async().await;
118        let client = Client::<ReqwestExecutor>::builder()
119            .with_api_key("secret".into())
120            .with_base_url(server.url())
121            .build()
122            .unwrap();
123
124        let _m = server
125            .mock("GET", "/tv/popular")
126            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
127            .with_status(404)
128            .with_header("content-type", "application/json")
129            .with_body(include_str!("../../assets/resource-not-found.json"))
130            .create_async()
131            .await;
132
133        let err = TVShowPopular::default().execute(&client).await.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 super::TVShowPopular;
142    use crate::client::Client;
143    use crate::client::reqwest::ReqwestExecutor;
144    use crate::prelude::Command;
145
146    #[tokio::test]
147    async fn execute() {
148        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
149        let client = Client::<ReqwestExecutor>::new(secret);
150
151        let _result = TVShowPopular::default().execute(&client).await.unwrap();
152    }
153}