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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

use std::{io, path::PathBuf, result};

#[cfg(feature = "autoconfig")]
use http::ureq::http::{StatusCode, Uri};
use thiserror::Error;

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

/// The global `Error` enum of the module.
#[derive(Debug, Error)]
pub enum Error {
    #[error("cannot get configuration of account {0}")]
    GetAccountConfigNotFoundError(String),

    #[cfg(feature = "sync")]
    #[error("cannot get sync directory from XDG_DATA_HOME")]
    GetXdgDataDirSyncError,
    #[cfg(feature = "sync")]
    #[error("cannot get invalid or missing synchronization directory {1}")]
    GetSyncDirInvalidError(#[source] shellexpand_utils::Error, PathBuf),

    #[error("cannot parse download file name from {0}")]
    ParseDownloadFileNameError(PathBuf),
    #[error("cannot get file name from path {0}")]
    GetFileNameFromPathSyncError(PathBuf),
    #[cfg(feature = "oauth2")]
    #[error("cannot create oauth2 client")]
    InitOauthClientError(#[source] oauth::v2_0::Error),
    #[cfg(feature = "oauth2")]
    #[error("cannot create oauth2 client")]
    BuildOauthClientError(#[source] oauth::v2_0::Error),
    #[cfg(feature = "oauth2")]
    #[error("cannot wait for oauth2 redirection error")]
    WaitForOauthRedirectionError(#[source] oauth::v2_0::Error),

    #[error("cannot get oauth2 access token from global keyring")]
    GetAccessTokenOauthError(#[source] secret::Error),
    #[error("cannot set oauth2 access token")]
    SetAccessTokenOauthError(#[source] secret::Error),
    #[cfg(feature = "oauth2")]
    #[error("cannot refresh oauth2 access token")]
    RefreshAccessTokenOauthError(#[source] oauth::v2_0::Error),
    #[error("cannot delete oauth2 access token from global keyring")]
    DeleteAccessTokenOauthError(#[source] secret::Error),

    #[error("cannot get oauth2 refresh token")]
    GetRefreshTokenOauthError(#[source] secret::Error),
    #[error("cannot set oauth2 refresh token")]
    SetRefreshTokenOauthError(#[source] secret::Error),
    #[error("cannot delete oauth2 refresh token from global keyring")]
    DeleteRefreshTokenOauthError(#[source] secret::Error),

    #[error("cannot get oauth2 client secret from user")]
    GetClientSecretFromUserOauthError(#[source] io::Error),
    #[error("cannot get oauth2 client secret from global keyring")]
    GetClientSecretFromKeyringOauthError(#[source] secret::Error),
    #[error("cannot save oauth2 client secret into global keyring")]
    SetClientSecretIntoKeyringOauthError(#[source] secret::Error),
    #[error("cannot delete oauth2 client secret from global keyring")]
    DeleteClientSecretOauthError(#[source] secret::Error),

    #[error("cannot get available port")]
    GetAvailablePortError,
    #[error("cannot get password from user")]
    GetFromUserError(#[source] io::Error),
    #[error("cannot get password from global keyring")]
    GetFromKeyringError(#[source] secret::Error),
    #[error("cannot save password into global keyring")]
    SetIntoKeyringError(#[source] secret::Error),
    #[error("cannot delete password from global keyring")]
    DeletePasswordFromKeyringError(#[source] secret::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot delete pgp key from keyring")]
    DeletePgpKeyFromKeyringError(#[source] keyring::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot delete pgp key at {1}")]
    DeletePgpKeyAtPathError(#[source] io::Error, PathBuf),
    #[cfg(feature = "pgp-native")]
    #[error("cannot generate pgp key pair for {1}")]
    GeneratePgpKeyPairError(#[source] pgp::Error, String),
    #[cfg(feature = "pgp-native")]
    #[error("cannot export secret key to armored string")]
    ExportSecretKeyToArmoredStringError(#[source] pgp::native::errors::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot export public key to armored string")]
    ExportPublicKeyToArmoredStringError(#[source] pgp::native::errors::Error),
    #[error("cannot write secret key file at {1}")]
    WriteSecretKeyFileError(#[source] io::Error, PathBuf),
    #[error("cannot write public key file at {1}")]
    WritePublicKeyFileError(#[source] io::Error, PathBuf),
    #[cfg(feature = "pgp-native")]
    #[error("cannot get public key from keyring")]
    GetPublicKeyFromKeyringError(#[source] keyring::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot set secret key to keyring")]
    SetSecretKeyToKeyringError(#[source] keyring::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot set public key to keyring")]
    SetPublicKeyToKeyringError(#[source] keyring::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot get secret key password")]
    GetPgpSecretKeyPasswdError(#[source] io::Error),
    #[cfg(feature = "pgp-native")]
    #[error("cannot create keyring entry from key: {0}")]
    KeyringError(#[from] keyring::Error),
    #[error("cannot find any MX record at {0}")]
    GetMxRecordNotFoundError(String),
    #[error("cannot find any mailconf TXT record at {0}")]
    GetMailconfTxtRecordNotFoundError(String),
    #[error("cannot find any SRV record at {0}")]
    GetSrvRecordNotFoundError(String),
    #[cfg(feature = "autoconfig")]
    #[error("cannot do txt lookup: {0}")]
    TXTLookUpFailure(#[source] hickory_resolver::error::ResolveError),
    #[cfg(feature = "autoconfig")]
    #[error("cannot do mx lookup: {0}")]
    MXLookUpFailure(#[source] hickory_resolver::error::ResolveError),
    #[cfg(feature = "autoconfig")]
    #[error("cannot do srv lookup: {0}")]
    SRVLookUpFailure(#[source] hickory_resolver::error::ResolveError),
    #[cfg(feature = "autoconfig")]
    #[error("cannot get autoconfig from {0}: {1}")]
    GetAutoConfigError(Uri, StatusCode),
    #[cfg(feature = "autoconfig")]
    #[error("cannot do a get request for autoconfig from {0}: {1}")]
    GetConnectionAutoConfigError(Uri, #[source] http::Error),
    #[cfg(feature = "autoconfig")]
    #[error("cannot get the body of response for autoconfig from {0}: {1}")]
    ToBytesAutoConfigError(Uri, #[source] http::Error),
    #[cfg(feature = "autoconfig")]
    #[error("cannot decode the body of response for autoconfig from {0}: {1}")]
    SerdeXmlFailedForAutoConfig(Uri, #[source] serde_xml_rs::Error),
    #[cfg(feature = "autoconfig")]
    #[error("cannot parse email {0}: {1}")]
    ParsingEmailAddress(String, #[source] email_address::Error),
}