io_gmail/v1/rest/drafts/
get.rs

1//! Get a Gmail draft (`users.drafts.get`).
2//!
3//! <https://developers.google.com/gmail/api/reference/rest/v1/users.drafts/get>
4
5use alloc::format;
6
7use io_http::rfc6750::bearer::HttpAuthBearer;
8use log::{debug, trace};
9use serde_variant::to_variant_name;
10use url::Url;
11
12use crate::{
13    coroutine::*,
14    gmail_try,
15    v1::{
16        rest::{drafts::GmailDraft, messages::GmailMessageFormat},
17        send::{GMAIL_API_BASE, GmailSend, GmailSendError, GmailSendOutput},
18    },
19};
20
21/// Gmail REST draft retrieval, wrapping a `GmailDraft` response.
22pub struct GmailDraftGet {
23    send: GmailSend<GmailDraft>,
24}
25
26impl GmailDraftGet {
27    /// Builds the `users.drafts.get` request for the given draft id
28    /// and message format.
29    pub fn new(
30        auth: &HttpAuthBearer,
31        user_id: &str,
32        id: &str,
33        format: GmailMessageFormat,
34    ) -> Result<Self, GmailSendError> {
35        debug!("prepare gmail draft retrieval");
36        trace!("id: {id:?}");
37
38        let mut url = Url::parse(GMAIL_API_BASE)?.join(&format!("users/{user_id}/drafts/{id}"))?;
39
40        {
41            let mut query = url.query_pairs_mut();
42            query.append_pair("format", to_variant_name(&format).unwrap_or_default());
43        }
44
45        let send = GmailSend::get(auth, url);
46
47        Ok(Self { send })
48    }
49}
50
51impl GmailCoroutine for GmailDraftGet {
52    type Yield = GmailYield;
53    type Return = Result<GmailSendOutput<GmailDraft>, GmailSendError>;
54
55    fn resume(&mut self, arg: Option<&[u8]>) -> GmailCoroutineState<Self::Yield, Self::Return> {
56        let out = gmail_try!(&mut self.send, arg);
57        debug!("draft retrieved");
58        trace!("out: {out:?}");
59        GmailCoroutineState::Complete(Ok(out))
60    }
61}
io_gmail/v1/rest/drafts/get.rs

io_gmail/v1/rest/drafts/
get.rs
