Enum vsmtp_common::transfer::Status

#[non_exhaustive]
pub enum Status {
    Waiting {
        timestamp: OffsetDateTime,
    },
    Sent {
        timestamp: OffsetDateTime,
    },
    HeldBack {
        errors: Vec<Error>,
    },
    Failed {
        error: Error,
    },
}

the delivery status of the email of the current rcpt.

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.

Waiting

Fields

timestamp: OffsetDateTime

timestamp when the status has been set

the email has not been sent yet. the email is in the deliver / working queue at this point.

Sent

Fields

timestamp: OffsetDateTime

timestamp when the status has been set

email for this recipient has been successfully sent. When all recipient are Status::Sent, the files are removed from disk.

HeldBack

Fields

errors: Vec<Error>

timestamp when the status has been set

the delivery failed, the system is trying to re-send the email. the email is located in the deferred queue at this point.

Failed

Fields

error: Error

the email failed too many times. the argument is the reason of the failure. the email is probably written in the dead or quarantine queues at this point.

Implementations

impl Status

pub const fn is_sendable(&self) -> bool

Should the recipient be delivered, or it has been done already ?

pub fn held_back(&mut self, error: impl Into<Variant>)

Set the status to Status::HeldBack with an error, or increase the previous stack.

pub fn sent() -> Self

pub fn failed(error: impl Into<Variant>) -> Self

Trait Implementations

impl Clone for Status

fn clone(&self) -> Status

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Status

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

Formats the value using the given formatter.

impl Default for Status

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Status

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Status

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.