io-email 0.1.0

Email client library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! Maildir mailbox-create coroutine wrapping
//! [`io_maildir::maildir::create::MaildirCreate`]: creates the
//! mailbox dir with its cur/new/tmp triad under the [`MaildirStore`].
//!
//! # Example
//!
//! ```rust,ignore
//! use io_email::mailbox::maildir::create::MaildirMailboxCreate;
//!
//! client.run(MaildirMailboxCreate::new(&client.store, "Archive")?)?;
//! ```

use io_maildir::{
    coroutine::*,
    maildir::create::{
        MaildirCreate as InnerMaildirCreate, MaildirCreateError as InnerMaildirCreateError,
    },
    store::MaildirStore,
};
use log::trace;
use thiserror::Error;

use crate::maildir::convert::{InvalidMailboxName, mailbox_path};

/// Errors produced by [`MaildirMailboxCreate`].
#[derive(Debug, Error)]
pub enum MaildirMailboxCreateError {
    #[error(transparent)]
    Create(#[from] InnerMaildirCreateError),
    #[error(transparent)]
    InvalidMailbox(#[from] InvalidMailboxName),
}

/// I/O-free coroutine creating a Maildir mailbox under the store.
pub struct MaildirMailboxCreate {
    inner: InnerMaildirCreate,
}

impl MaildirMailboxCreate {
    pub fn new(store: &MaildirStore, name: &str) -> Result<Self, MaildirMailboxCreateError> {
        trace!("prepare Maildir mailbox create");
        let path = mailbox_path(name)?;
        Ok(Self {
            inner: InnerMaildirCreate::new(store, path),
        })
    }
}

impl MaildirCoroutine for MaildirMailboxCreate {
    type Yield = MaildirYield;
    type Return = Result<(), MaildirMailboxCreateError>;

    fn resume(
        &mut self,
        arg: Option<MaildirReply>,
    ) -> MaildirCoroutineState<Self::Yield, Self::Return> {
        match self.inner.resume(arg) {
            MaildirCoroutineState::Yielded(y) => MaildirCoroutineState::Yielded(y),
            MaildirCoroutineState::Complete(r) => {
                MaildirCoroutineState::Complete(r.map_err(Into::into))
            }
        }
    }
}