Skip to main content

io_gmail/v1/rest/settings/
get_language.rs

1//! Get the Gmail language settings (`users.settings.getLanguage`).
2//!
3//! <https://developers.google.com/gmail/api/reference/rest/v1/users.settings/getLanguage>
4
5use alloc::format;
6
7use io_http::rfc6750::bearer::HttpAuthBearer;
8use log::{debug, trace};
9use url::Url;
10
11use crate::{
12    coroutine::*,
13    gmail_try,
14    v1::{
15        rest::settings::GmailLanguageSettings,
16        send::{GMAIL_API_BASE, GmailSend, GmailSendError, GmailSendOutput},
17    },
18};
19
20/// I/O-free coroutine getting the Gmail display language settings
21/// (`users.settings.getLanguage`).
22pub struct GmailLanguageGet {
23    send: GmailSend<GmailLanguageSettings>,
24}
25
26impl GmailLanguageGet {
27    /// Builds the `users.settings.getLanguage` request for the given user.
28    pub fn new(auth: &HttpAuthBearer, user_id: &str) -> Result<Self, GmailSendError> {
29        debug!("prepare gmail language settings retrieval");
30        trace!("user_id: {user_id:?}");
31
32        let url =
33            Url::parse(GMAIL_API_BASE)?.join(&format!("users/{user_id}/settings/language"))?;
34        let send = GmailSend::get(auth, url);
35
36        Ok(Self { send })
37    }
38}
39
40impl GmailCoroutine for GmailLanguageGet {
41    type Yield = GmailYield;
42    type Return = Result<GmailSendOutput<GmailLanguageSettings>, GmailSendError>;
43
44    fn resume(&mut self, arg: Option<&[u8]>) -> GmailCoroutineState<Self::Yield, Self::Return> {
45        let out = gmail_try!(&mut self.send, arg);
46        debug!("language settings retrieved");
47        trace!("out: {out:?}");
48        GmailCoroutineState::Complete(Ok(out))
49    }
50}