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::ReqwestExecutor;
11    ///
12    /// #[tokio::main]
13    /// async fn main() {
14    ///     let client = Client::<ReqwestExecutor>::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 crate::client::Client;
34    use crate::client::reqwest::ReqwestExecutor;
35    use mockito::Matcher;
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", "/movie/550/recommendations")
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/movie-recommendations.json"))
52            .create_async()
53            .await;
54
55        let result = client
56            .get_movie_recommendations(550, &Default::default())
57            .await
58            .unwrap();
59        assert_eq!(result.page, 1);
60        assert!(!result.results.is_empty());
61    }
62
63    #[tokio::test]
64    async fn invalid_api_key() {
65        let mut server = mockito::Server::new_async().await;
66        let client = Client::<ReqwestExecutor>::builder()
67            .with_api_key("secret".into())
68            .with_base_url(server.url())
69            .build()
70            .unwrap();
71
72        let _m = server
73            .mock("GET", "/movie/550/recommendations")
74            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
75            .with_status(401)
76            .with_header("content-type", "application/json")
77            .with_body(include_str!("../../assets/invalid-api-key.json"))
78            .create_async()
79            .await;
80
81        let err = client
82            .get_movie_recommendations(550, &Default::default())
83            .await
84            .unwrap_err();
85        let server_err = err.as_server_error().unwrap();
86        assert_eq!(server_err.status_code, 7);
87    }
88
89    #[tokio::test]
90    async fn resource_not_found() {
91        let mut server = mockito::Server::new_async().await;
92        let client = Client::<ReqwestExecutor>::builder()
93            .with_api_key("secret".into())
94            .with_base_url(server.url())
95            .build()
96            .unwrap();
97
98        let _m = server
99            .mock("GET", "/movie/550/recommendations")
100            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
101            .with_status(404)
102            .with_header("content-type", "application/json")
103            .with_body(include_str!("../../assets/resource-not-found.json"))
104            .create_async()
105            .await;
106
107        let err = client
108            .get_movie_recommendations(550, &Default::default())
109            .await
110            .unwrap_err();
111        let server_err = err.as_server_error().unwrap();
112        assert_eq!(server_err.status_code, 34);
113    }
114}
115
116#[cfg(all(test, feature = "integration"))]
117mod integration_tests {
118    use crate::client::Client;
119    use crate::client::reqwest::ReqwestExecutor;
120
121    #[tokio::test]
122    async fn execute() {
123        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
124        let client = Client::<ReqwestExecutor>::new(secret);
125
126        let result = client
127            .get_movie_recommendations(550, &Default::default())
128            .await
129            .unwrap();
130        assert_eq!(result.page, 1);
131    }
132}