tmdb_api/movie/
keywords.rs

1use std::borrow::Cow;
2
3use crate::common::keyword::Keyword;
4
5/// Get the keywords that have been added to a movie.
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::movie::keywords::MovieKeywords;
12///
13/// #[tokio::main]
14/// async fn main() {
15///     let client = Client::<ReqwestExecutor>::new("this-is-my-secret-token".into());
16///     let cmd = MovieKeywords::new(1);
17///     let result = cmd.execute(&client).await;
18///     match result {
19///         Ok(res) => println!("found: {:#?}", res),
20///         Err(err) => eprintln!("error: {:?}", err),
21///     };
22/// }
23/// ```
24#[derive(Clone, Debug, Default)]
25pub struct MovieKeywords {
26    /// ID of the movie
27    pub movie_id: u64,
28}
29
30impl MovieKeywords {
31    pub fn new(movie_id: u64) -> Self {
32        Self { movie_id }
33    }
34}
35
36#[derive(Debug, Deserialize, Serialize)]
37pub struct MovieKeywordsResult {
38    pub id: u64,
39    pub keywords: Vec<Keyword>,
40}
41
42impl crate::prelude::Command for MovieKeywords {
43    type Output = MovieKeywordsResult;
44
45    fn path(&self) -> Cow<'static, str> {
46        Cow::Owned(format!("/movie/{}/keywords", self.movie_id))
47    }
48
49    fn params(&self) -> Vec<(&'static str, Cow<'_, str>)> {
50        Vec::new()
51    }
52}
53
54#[cfg(test)]
55mod tests {
56    use super::MovieKeywords;
57    use crate::client::Client;
58    use crate::client::reqwest::ReqwestExecutor;
59    use crate::prelude::Command;
60    use mockito::Matcher;
61
62    #[tokio::test]
63    async fn it_works() {
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 cmd = MovieKeywords::new(550);
72
73        let _m = server
74            .mock("GET", "/movie/550/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/movie-keywords.json"))
79            .create_async()
80            .await;
81        let result = cmd.execute(&client).await.unwrap();
82        assert_eq!(result.id, 550);
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 cmd = MovieKeywords::new(42);
95
96        let _m = server
97            .mock("GET", "/movie/42/keywords")
98            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
99            .with_status(401)
100            .with_header("content-type", "application/json")
101            .with_body(include_str!("../../assets/invalid-api-key.json"))
102            .create_async()
103            .await;
104        let err = cmd.execute(&client).await.unwrap_err();
105        let server_err = err.as_server_error().unwrap();
106        assert_eq!(server_err.status_code, 7);
107    }
108
109    #[tokio::test]
110    async fn resource_not_found() {
111        let mut server = mockito::Server::new_async().await;
112        let client = Client::<ReqwestExecutor>::builder()
113            .with_api_key("secret".into())
114            .with_base_url(server.url())
115            .build()
116            .unwrap();
117
118        let cmd = MovieKeywords::new(42);
119
120        let _m = server
121            .mock("GET", "/movie/42/keywords")
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        let err = cmd.execute(&client).await.unwrap_err();
129        let server_err = err.as_server_error().unwrap();
130        assert_eq!(server_err.status_code, 34);
131    }
132}
133
134#[cfg(all(test, feature = "integration"))]
135mod integration_tests {
136    use super::MovieKeywords;
137    use crate::client::Client;
138    use crate::client::reqwest::ReqwestExecutor;
139    use crate::prelude::Command;
140
141    #[tokio::test]
142    async fn execute() {
143        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
144        let client = Client::<ReqwestExecutor>::new(secret);
145        let cmd = MovieKeywords::new(550);
146
147        let result = cmd.execute(&client).await.unwrap();
148        assert_eq!(result.id, 550);
149    }
150}
tmdb_api/movie/keywords.rs

tmdb_api/movie/
keywords.rs
