Enum imap::error::Error

#[non_exhaustive]
pub enum Error {
    Io(Error),
    RustlsHandshake(HandshakeError<TcpStream>),
    TlsHandshake(HandshakeError<TcpStream>),
    Tls(Error),
    Bad(Bad),
    No(No),
    Bye(Bye),
    ConnectionLost,
    Parse(ParseError),
    Validate(ValidateError),
    Append,
    Unexpected(Response<'static>),
    MissingStatusResponse,
    TagMismatch(TagMismatch),
    StartTlsNotAvailable,
    TlsNotConfigured,
}

A set of errors that can occur in the IMAP client

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

An io::Error that occurred while trying to read or write to a network stream.

RustlsHandshake(HandshakeError<TcpStream>)

An error from the rustls library during the TLS handshake.

TlsHandshake(HandshakeError<TcpStream>)

An error from the native_tls library during the TLS handshake.

Tls(Error)

An error from the native_tls library while managing the socket.

Bad(Bad)

A BAD response from the IMAP server.

No(No)

A NO response from the IMAP server.

Bye(Bye)

A BYE response from the IMAP server.

ConnectionLost

The connection was terminated unexpectedly.

Parse(ParseError)

Error parsing a server response.

Validate(ValidateError)

Command inputs were not valid IMAP strings.

Append

Error appending an e-mail.

Unexpected(Response<'static>)

An unexpected response was received. This could be a response from a command, or an unsolicited response that could not be converted into a local type in UnsolicitedResponse.

MissingStatusResponse

In response to a STATUS command, the server sent OK without actually sending any STATUS responses first.

TagMismatch(TagMismatch)

The server responded with a different command tag than the one we just sent.

A new session must generally be established to recover from this. You can also use Connection::skip_tag (which is available through both Client and Session).

StartTlsNotAvailable

StartTls is not available on the server

TlsNotConfigured

Returns when Tls is not configured

Trait Implementations

impl Debug for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn StdError>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<Error> for Error

fn from(err: TlsError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: IoError) -> Error

Converts to this type from the input type.

impl From<HandshakeError<TcpStream>> for Error

fn from(err: TlsHandshakeError<TcpStream>) -> Error

Converts to this type from the input type.

impl From<HandshakeError<TcpStream>> for Error

fn from(err: RustlsHandshakeError<TcpStream>) -> Error

Converts to this type from the input type.

impl<T> From<IntoInnerError<T>> for Error

fn from(err: BufError<T>) -> Error

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(err: ParseError) -> Error

Converts to this type from the input type.

impl<'a> From<Response<'a>> for Error

fn from(err: Response<'a>) -> Error

Converts to this type from the input type.