Skip to main content

io_gmail/v1/rest/messages/
delete.rs

1//! Delete a Gmail message (`users.messages.delete`).
2//!
3//! <https://developers.google.com/gmail/api/reference/rest/v1/users.messages/delete>
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::send::{GMAIL_API_BASE, GmailNoResponse, GmailSend, GmailSendError, GmailSendOutput},
15};
16
17/// Gmail REST message permanent deletion, yielding no response body.
18pub struct GmailMessageDelete {
19    send: GmailSend<GmailNoResponse>,
20}
21
22impl GmailMessageDelete {
23    /// Builds the `users.messages.delete` request for the given
24    /// message id.
25    pub fn new(auth: &HttpAuthBearer, user_id: &str, id: &str) -> Result<Self, GmailSendError> {
26        debug!("prepare gmail message deletion");
27        trace!("id: {id:?}");
28
29        let url = Url::parse(GMAIL_API_BASE)?.join(&format!("users/{user_id}/messages/{id}"))?;
30        let send = GmailSend::delete(auth, url);
31
32        Ok(Self { send })
33    }
34}
35
36impl GmailCoroutine for GmailMessageDelete {
37    type Yield = GmailYield;
38    type Return = Result<GmailSendOutput<GmailNoResponse>, GmailSendError>;
39
40    fn resume(&mut self, arg: Option<&[u8]>) -> GmailCoroutineState<Self::Yield, Self::Return> {
41        let out = gmail_try!(&mut self.send, arg);
42        debug!("message deleted");
43        trace!("out: {out:?}");
44        GmailCoroutineState::Complete(Ok(out))
45    }
46}