Enum imap::types::UnsolicitedResponse[][src]

#[non_exhaustive]pub enum UnsolicitedResponse {
    Status {
        mailbox: String,
        attributes: Vec<StatusAttribute>,
    },
    Recent(u32),
    Exists(u32),
    Expunge(Seq),
    Metadata {
        mailbox: String,
        metadata_entries: Vec<String>,
    },
    Vanished {
        earlier: bool,
        uids: Vec<RangeInclusive<u32>>,
    },
    Flags(Vec<Flag<'static>>),
}

Responses that the server sends that are not related to the current command. RFC 3501 states that clients need to be able to accept any response at any time. These are the ones we’ve encountered in the wild.

Note that Recent, Exists and Expunge responses refer to the currently SELECTed folder, so the user must take care when interpreting these.

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.
Status

An unsolicited STATUS response.

Fields of Status

mailbox: String

The mailbox that this status response is for.

attributes: Vec<StatusAttribute>

The attributes of this mailbox.

Recent(u32)

An unsolicited RECENT response indicating the number of messages with the \Recent flag set. This response occurs if the size of the mailbox changes (e.g., new messages arrive).

Note: It is not guaranteed that the message sequence numbers of recent messages will be a contiguous range of the highest n messages in the mailbox (where n is the value reported by the RECENT response). Examples of situations in which this is not the case are: multiple clients having the same mailbox open (the first session to be notified will see it as recent, others will probably see it as non-recent), and when the mailbox is re-ordered by a non-IMAP agent.

The only reliable way to identify recent messages is to look at message flags to see which have the \Recent flag set, or to do a SEARCH RECENT.

Exists(u32)

An unsolicited EXISTS response that reports the number of messages in the mailbox. This response occurs if the size of the mailbox changes (e.g., new messages arrive).

Expunge(Seq)

An unsolicited EXPUNGE response that reports that the specified message sequence number has been permanently removed from the mailbox. The message sequence number for each successive message in the mailbox is immediately decremented by 1, and this decrement is reflected in message sequence numbers in subsequent responses (including other untagged EXPUNGE responses).

The EXPUNGE response also decrements the number of messages in the mailbox; it is not necessary to send an EXISTS response with the new value.

As a result of the immediate decrement rule, message sequence numbers that appear in a set of successive EXPUNGE responses depend upon whether the messages are removed starting from lower numbers to higher numbers, or from higher numbers to lower numbers. For example, if the last 5 messages in a 9-message mailbox are expunged, a “lower to higher” server will send five untagged EXPUNGE responses for message sequence number 5, whereas a “higher to lower server” will send successive untagged EXPUNGE responses for message sequence numbers 9, 8, 7, 6, and 5.

Metadata

An unsolicited METADATA response (https://tools.ietf.org/html/rfc5464#section-4.4.2) that reports a change in a server or mailbox annotation.

Fields of Metadata

mailbox: String

Mailbox name for which annotations were changed.

metadata_entries: Vec<String>

List of annotations that were changed.

Vanished

An unsolicited VANISHED response that reports a sequence-set of UIDs that have been expunged from the mailbox.

The VANISHED response is similar to the EXPUNGE response and can be sent wherever an EXPUNGE response can be sent. It can only be sent by the server if the client has enabled QRESYNC.

The VANISHED response has two forms, one with the EARLIER tag which is used to respond to a UID FETCH or SELECT/EXAMINE command, and one without an EARLIER tag, which is used to announce removals within an already selected mailbox.

If using QRESYNC, the client can fetch new, updated and deleted UIDs in a single round trip by including the (CHANGEDSINCE <MODSEQ> VANISHED) modifier to the UID SEARCH command, as described in RFC7162. For example UID FETCH 1:* (UID FLAGS) (CHANGEDSINCE 1234 VANISHED) would return FETCH results for all UIDs added or modified since MODSEQ 1234. Deleted UIDs will be present as a VANISHED response in the Session::unsolicited_responses channel.

Fields of Vanished

earlier: bool

Whether the EARLIER tag was set on the response

uids: Vec<RangeInclusive<u32>>

The list of UIDs which have been removed

Flags(Vec<Flag<'static>>)

An unsolicited FLAGS response that identifies the flags (at a minimum, the system-defined flags) that are applicable in the mailbox. Flags other than the system flags can also exist, depending on server implementation.

See Flag for details.

Trait Implementations

impl Debug for UnsolicitedResponse[src]

impl Eq for UnsolicitedResponse[src]

impl PartialEq<UnsolicitedResponse> for UnsolicitedResponse[src]

impl StructuralEq for UnsolicitedResponse[src]

impl StructuralPartialEq for UnsolicitedResponse[src]

Auto Trait Implementations

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Conv for T

impl<T> Conv for T

impl<T> FmtForward for T

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> Pipe for T where
    T: ?Sized

impl<T> Pipe for T

impl<T> PipeAsRef for T

impl<T> PipeBorrow for T

impl<T> PipeDeref for T

impl<T> PipeRef for T

impl<T> Tap for T

impl<T> Tap for T

impl<T, U> TapAsRef<U> for T where
    U: ?Sized

impl<T, U> TapBorrow<U> for T where
    U: ?Sized

impl<T> TapDeref for T

impl<T> TryConv for T

impl<T> TryConv for T

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,