Skip to main content

io_gmail/v1/rest/messages/
untrash.rs

1//! Untrash a Gmail message (`users.messages.untrash`).
2//!
3//! <https://developers.google.com/gmail/api/reference/rest/v1/users.messages/untrash>
4
5use alloc::{format, vec::Vec};
6
7use io_http::rfc6750::bearer::HttpAuthBearer;
8use log::{debug, trace};
9use url::Url;
10
11use crate::{
12    coroutine::*,
13    gmail_try,
14    v1::rest::messages::GmailMessage,
15    v1::send::{GMAIL_API_BASE, GmailSend, GmailSendError, GmailSendOutput},
16};
17
18/// Gmail REST message untrashing, wrapping the updated `GmailMessage`.
19pub struct GmailMessageUntrash {
20    send: GmailSend<GmailMessage>,
21}
22
23impl GmailMessageUntrash {
24    /// Builds the `users.messages.untrash` request for the given
25    /// message id.
26    pub fn new(auth: &HttpAuthBearer, user_id: &str, id: &str) -> Result<Self, GmailSendError> {
27        debug!("prepare gmail message untrashing");
28        trace!("id: {id:?}");
29
30        let url =
31            Url::parse(GMAIL_API_BASE)?.join(&format!("users/{user_id}/messages/{id}/untrash"))?;
32        let send = GmailSend::with_method(auth, "POST", url, None, Vec::new());
33
34        Ok(Self { send })
35    }
36}
37
38impl GmailCoroutine for GmailMessageUntrash {
39    type Yield = GmailYield;
40    type Return = Result<GmailSendOutput<GmailMessage>, GmailSendError>;
41
42    fn resume(&mut self, arg: Option<&[u8]>) -> GmailCoroutineState<Self::Yield, Self::Return> {
43        let out = gmail_try!(&mut self.send, arg);
44        debug!("message untrashed");
45        trace!("out: {out:?}");
46        GmailCoroutineState::Complete(Ok(out))
47    }
48}