tmdb_api/movie/
recommendations.rs

1use crate::common::PaginatedResult;
2
3pub type Params<'a> = crate::common::LanguagePageParams<'a>;
4
5impl<E: crate::client::Executor> crate::Client<E> {
6    /// Get a list of recommended movies for a movie.
7    ///
8    /// ```rust
9    /// use tmdb_api::client::Client;
10    /// use tmdb_api::client::reqwest::Client as ReqwestClient;
11    ///
12    /// #[tokio::main]
13    /// async fn main() {
14    ///     let client = Client::<ReqwestClient>::new("this-is-my-secret-token".into());
15    ///     match client.get_movie_recommendations(1, &Default::default()).await {
16    ///         Ok(res) => println!("found: {:#?}", res),
17    ///         Err(err) => eprintln!("error: {:?}", err),
18    ///     };
19    /// }
20    /// ```
21    pub async fn get_movie_recommendations(
22        &self,
23        movie_id: u64,
24        params: &Params<'_>,
25    ) -> crate::Result<PaginatedResult<super::MovieShort>> {
26        let url = format!("/movie/{movie_id}/recommendations");
27        self.execute(&url, params).await
28    }
29}
30
31#[cfg(test)]
32mod tests {
33    use mockito::Matcher;
34
35    use crate::client::Client;
36    use crate::client::reqwest::Client as ReqwestClient;
37
38    #[tokio::test]
39    async fn it_works() {
40        let mut server = mockito::Server::new_async().await;
41        let client = Client::<ReqwestClient>::builder()
42            .with_api_key("secret".into())
43            .with_base_url(server.url())
44            .build()
45            .unwrap();
46
47        let _m = server
48            .mock("GET", "/movie/550/recommendations")
49            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
50            .with_status(200)
51            .with_header("content-type", "application/json")
52            .with_body(include_str!("../../assets/movie-recommendations.json"))
53            .create_async()
54            .await;
55
56        let result = client
57            .get_movie_recommendations(550, &Default::default())
58            .await
59            .unwrap();
60        assert_eq!(result.page, 1);
61        assert!(!result.results.is_empty());
62    }
63
64    #[tokio::test]
65    async fn invalid_api_key() {
66        let mut server = mockito::Server::new_async().await;
67        let client = Client::<ReqwestClient>::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", "/movie/550/recommendations")
75            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
76            .with_status(401)
77            .with_header("content-type", "application/json")
78            .with_body(include_str!("../../assets/invalid-api-key.json"))
79            .create_async()
80            .await;
81
82        let err = client
83            .get_movie_recommendations(550, &Default::default())
84            .await
85            .unwrap_err();
86        let server_err = err.as_server_error().unwrap();
87        assert_eq!(server_err.status_code, 7);
88    }
89
90    #[tokio::test]
91    async fn resource_not_found() {
92        let mut server = mockito::Server::new_async().await;
93        let client = Client::<ReqwestClient>::builder()
94            .with_api_key("secret".into())
95            .with_base_url(server.url())
96            .build()
97            .unwrap();
98
99        let _m = server
100            .mock("GET", "/movie/550/recommendations")
101            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
102            .with_status(404)
103            .with_header("content-type", "application/json")
104            .with_body(include_str!("../../assets/resource-not-found.json"))
105            .create_async()
106            .await;
107
108        let err = client
109            .get_movie_recommendations(550, &Default::default())
110            .await
111            .unwrap_err();
112        let server_err = err.as_server_error().unwrap();
113        assert_eq!(server_err.status_code, 34);
114    }
115}
116
117#[cfg(all(test, feature = "integration"))]
118mod integration_tests {
119    use crate::client::Client;
120    use crate::client::reqwest::Client as ReqwestClient;
121
122    #[tokio::test]
123    async fn execute() {
124        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
125        let client = Client::<ReqwestClient>::new(secret);
126
127        let result = client
128            .get_movie_recommendations(550, &Default::default())
129            .await
130            .unwrap();
131        assert_eq!(result.page, 1);
132    }
133}