email-lib 0.27.0

Cross-platform, asynchronous Rust library to manage emails
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
65
66
67

use std::{any::Any, result};

use thiserror::Error;
use tokio::task::JoinError;

use crate::{AnyBoxedError, AnyError};

/// The global `Result` alias of the module.
pub type Result<T> = result::Result<T, Error>;

/// The global `Result` alias of the module.
#[derive(Debug, Error)]
pub enum Error {
    #[cfg(feature = "maildir")]
    #[error("cannot create maildir folder structure at {1}")]
    CreateFolderStructureMaildirError(#[source] maildirs::Error, std::path::PathBuf),
    #[cfg(feature = "maildir")]
    #[error("cannot create notmuch folder {1}")]
    CreateFolderStructureNotmuchError(#[source] maildirs::Error, String),
    #[cfg(feature = "maildir")]
    #[error("cannot delete maildir folder {1} at {0}")]
    DeleteMaildirFolderError(#[source] maildirs::Error, String),
    #[cfg(feature = "maildir")]
    #[error("cannot delete maildir INBOX at {0}")]
    DeleteMaildirInboxForbiddenError(std::path::PathBuf),
    #[cfg(feature = "maildir")]
    #[error("maildir: cannot list current folder from {1}")]
    ListCurrentFolderMaildirError(#[source] maildirs::Error, std::path::PathBuf),
    #[cfg(feature = "maildir")]
    #[error("cannot remove maildir entry at {1}")]
    RemoveMaildirEntryError(#[source] maildirs::Error, std::path::PathBuf),
    #[error("cannot parse folder kind {0}")]
    ParseFolderKindError(String),
    #[error("cannot get uid of imap folder {0}: uid is missing")]
    GetUidMissingImapError(u32),
    #[error("cannot gather folders: {0}")]
    FolderTasksFailed(JoinError),

    #[error("cannot sync: cannot list folders from left cache")]
    ListLeftFoldersCachedError(#[source] AnyBoxedError),
    #[error("cannot sync: cannot list folders from left backend")]
    ListLeftFoldersError(#[source] AnyBoxedError),
    #[error("cannot sync: cannot list folders from right cache")]
    ListRightFoldersCachedError(#[source] AnyBoxedError),
    #[error("cannot sync: cannot list folders from right backend")]
    ListRightFoldersError(#[source] AnyBoxedError),

    // ======== v2
    #[error("cannot parse IMAP mailbox {0}: mailbox not selectable")]
    ParseImapFolderNotSelectableError(String),

    #[cfg(feature = "maildir")]
    #[error(transparent)]
    MaildirsError(#[from] maildirs::Error),
}

impl AnyError for Error {
    fn as_any(&self) -> &dyn Any {
        self
    }
}

impl From<Error> for AnyBoxedError {
    fn from(err: Error) -> Self {
        Box::new(err)
    }
}