tmdb_api/tvshow/
keywords.rs

1//! https://developer.themoviedb.org/reference/tv-series-keywords
2
3use std::borrow::Cow;
4
5use crate::common::keyword::Keyword;
6
7/// Command to get the keywords of a tvshow.
8///
9/// ```rust
10/// use tmdb_api::prelude::Command;
11/// use tmdb_api::Client;
12/// use tmdb_api::client::reqwest::ReqwestExecutor;
13/// use tmdb_api::tvshow::keywords::TVShowKeywords;
14///
15/// #[tokio::main]
16/// async fn main() {
17///     let client = Client::<ReqwestExecutor>::new("this-is-my-secret-token".into());
18///     let cmd = TVShowKeywords::new(1);
19///     let result = cmd.execute(&client).await;
20///     match result {
21///         Ok(res) => println!("found: {:#?}", res),
22///         Err(err) => eprintln!("error: {:?}", err),
23///     };
24/// }
25/// ```
26#[derive(Clone, Debug, Default)]
27pub struct TVShowKeywords {
28    pub tv_show_id: u64,
29}
30
31#[derive(Debug, Deserialize)]
32pub struct TVShowKeywordsResult {
33    pub id: u64,
34    pub results: Vec<Keyword>,
35}
36
37impl TVShowKeywords {
38    pub fn new(tv_show_id: u64) -> Self {
39        Self { tv_show_id }
40    }
41}
42
43impl crate::prelude::Command for TVShowKeywords {
44    type Output = TVShowKeywordsResult;
45
46    fn path(&self) -> Cow<'static, str> {
47        Cow::Owned(format!("/tv/{}/keywords", self.tv_show_id))
48    }
49
50    fn params(&self) -> Vec<(&'static str, Cow<'_, str>)> {
51        Vec::new()
52    }
53}
54
55#[cfg(test)]
56mod tests {
57    use mockito::Matcher;
58
59    use super::TVShowKeywords;
60    use crate::Client;
61    use crate::client::reqwest::ReqwestExecutor;
62    use crate::prelude::Command;
63
64    #[tokio::test]
65    async fn it_works() {
66        let mut server = mockito::Server::new_async().await;
67        let client = Client::<ReqwestExecutor>::builder()
68            .with_api_key("secret".into())
69            .with_base_url(server.url())
70            .build()
71            .unwrap();
72
73        let _m = server
74            .mock("GET", "/tv/1399/keywords")
75            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
76            .with_status(200)
77            .with_header("content-type", "application/json")
78            .with_body(include_str!("../../assets/tv-keywords.json"))
79            .create_async()
80            .await;
81
82        let result = TVShowKeywords::new(1399).execute(&client).await.unwrap();
83        assert_eq!(result.id, 1399);
84    }
85
86    #[tokio::test]
87    async fn invalid_api_key() {
88        let mut server = mockito::Server::new_async().await;
89        let client = Client::<ReqwestExecutor>::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/keywords")
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 = TVShowKeywords::new(1399)
105            .execute(&client)
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::<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/keywords")
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 = TVShowKeywords::new(1399)
131            .execute(&client)
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;
142    use crate::client::reqwest::ReqwestExecutor;
143    use crate::prelude::Command;
144
145    use super::TVShowKeywords;
146
147    #[tokio::test]
148    async fn execute() {
149        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
150        let client = Client::<ReqwestExecutor>::new(secret);
151
152        let result = TVShowKeywords::new(1399).execute(&client).await.unwrap();
153        assert_eq!(result.id, 1399);
154    }
155}
tmdb_api/tvshow/keywords.rs

tmdb_api/tvshow/
keywords.rs
