tmdb_api/configuration/
languages.rs

1//! https://developer.themoviedb.org/reference/configuration-languages
2
3use std::borrow::Cow;
4
5/// Get a list of all languages
6///
7/// ```rust
8/// use tmdb_api::prelude::Command;
9/// use tmdb_api::Client;
10/// use tmdb_api::client::reqwest::ReqwestExecutor;
11/// use tmdb_api::configuration::languages::Languages;
12///
13/// #[tokio::main]
14/// async fn main() {
15///     let client = Client::<ReqwestExecutor>::new("this-is-my-secret-token".into());
16///     let result = Languages::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 Languages {}
25
26#[derive(Debug, Deserialize)]
27pub struct LanguagesResult {
28    pub iso_639_1: String,
29    pub english_name: String,
30    /// Can be an empty string
31    pub name: String,
32}
33
34impl Languages {
35    pub fn new() -> Self {
36        Self {}
37    }
38}
39
40impl crate::prelude::Command for Languages {
41    type Output = Vec<LanguagesResult>;
42
43    fn path(&self) -> Cow<'static, str> {
44        Cow::Borrowed("/configuration/languages")
45    }
46
47    fn params(&self) -> Vec<(&'static str, Cow<'_, str>)> {
48        Vec::new()
49    }
50}
51
52#[cfg(test)]
53mod tests {
54    use mockito::Matcher;
55
56    use crate::Client;
57    use crate::client::reqwest::ReqwestExecutor;
58    use crate::prelude::Command;
59
60    use super::Languages;
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 _m = server
72            .mock("GET", "/configuration/languages")
73            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
74            .with_status(200)
75            .with_header("content-type", "application/json")
76            .with_body(include_str!("../../assets/configuration-languages.json"))
77            .create_async()
78            .await;
79
80        let result = Languages::default().execute(&client).await.unwrap();
81        assert!(!result.is_empty());
82    }
83
84    #[tokio::test]
85    async fn invalid_api_key() {
86        let mut server = mockito::Server::new_async().await;
87        let client = Client::<ReqwestExecutor>::builder()
88            .with_api_key("secret".into())
89            .with_base_url(server.url())
90            .build()
91            .unwrap();
92
93        let _m = server
94            .mock("GET", "/configuration/languages")
95            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
96            .with_status(401)
97            .with_header("content-type", "application/json")
98            .with_body(include_str!("../../assets/invalid-api-key.json"))
99            .create_async()
100            .await;
101
102        let err = Languages::default().execute(&client).await.unwrap_err();
103        let server_err = err.as_server_error().unwrap();
104        assert_eq!(server_err.status_code, 7);
105    }
106
107    #[tokio::test]
108    async fn resource_not_found() {
109        let mut server = mockito::Server::new_async().await;
110        let client = Client::<ReqwestExecutor>::builder()
111            .with_api_key("secret".into())
112            .with_base_url(server.url())
113            .build()
114            .unwrap();
115
116        let _m = server
117            .mock("GET", "/configuration/languages")
118            .match_query(Matcher::UrlEncoded("api_key".into(), "secret".into()))
119            .with_status(404)
120            .with_header("content-type", "application/json")
121            .with_body(include_str!("../../assets/resource-not-found.json"))
122            .create_async()
123            .await;
124
125        let err = Languages::default().execute(&client).await.unwrap_err();
126        let server_err = err.as_server_error().unwrap();
127        assert_eq!(server_err.status_code, 34);
128    }
129}
130
131#[cfg(all(test, feature = "integration"))]
132mod integration_tests {
133    use crate::Client;
134    use crate::client::reqwest::ReqwestExecutor;
135    use crate::prelude::Command;
136
137    use super::Languages;
138
139    #[tokio::test]
140    async fn execute() {
141        let secret = std::env::var("TMDB_TOKEN_V3").unwrap();
142        let client = Client::<ReqwestExecutor>::new(secret);
143
144        let result = Languages::default().execute(&client).await.unwrap();
145        assert!(!result.is_empty());
146    }
147}
tmdb_api/configuration/languages.rs

tmdb_api/configuration/
languages.rs
