Struct Capabilities 

pub struct Capabilities {

    pub imap4rev1: bool,
    pub imap4rev2: bool,
    pub starttls: bool,
    pub login_disabled: bool,
    pub idle: bool,
    pub unselect: bool,
    pub condstore: bool,
    pub qresync: bool,
    pub move_ext: bool,
    pub uidplus: bool,
    pub literal_plus: bool,
    pub literal_minus: bool,
    pub enable: bool,
    pub auth_plain: bool,
    pub auth_login: bool,
    pub auth_xoauth2: bool,
    pub auth_oauthbearer: bool,
}

Parsed view of a server’s advertised IMAP capabilities.

Each field is true when the corresponding capability atom was present in the server’s CAPABILITY list. Unknown atoms are ignored.

Fields

imap4rev1: bool

IMAP4rev1 (RFC 3501) base protocol.

imap4rev2: bool

IMAP4rev2 (RFC 9051) base protocol.

starttls: bool

STARTTLS — cleartext-to-TLS upgrade is supported.

login_disabled: bool

LOGINDISABLED — the LOGIN command is refused (typically pre-TLS).

idle: bool

IDLE (RFC 2177) — server-pushed mailbox updates.

unselect: bool

UNSELECT (RFC 3691) — leave the selected mailbox without expunging.

condstore: bool

CONDSTORE (RFC 7162) — conditional store / mod-sequences.

qresync: bool

QRESYNC (RFC 7162) — quick mailbox resynchronization.

move_ext: bool

MOVE (RFC 6851) — atomic message move.

uidplus: bool

UIDPLUS (RFC 4315) — UID EXPUNGE and assigned-UID responses.

literal_plus: bool

LITERAL+ (RFC 7888) — non-synchronizing literals.

literal_minus: bool

LITERAL- (RFC 7888) — non-synchronizing literals capped at 4096 octets.

enable: bool

ENABLE (RFC 5161) — opt into extensions for the session.

auth_plain: bool

AUTH=PLAIN SASL mechanism.

auth_login: bool

AUTH=LOGIN SASL mechanism.

auth_xoauth2: bool

AUTH=XOAUTH2 SASL mechanism.

auth_oauthbearer: bool

AUTH=OAUTHBEARER (RFC 7628) SASL mechanism.

Implementations

impl Capabilities

pub fn from_atoms<S: AsRef<str>>(atoms: &[S]) -> Self

Build from a list of capability atoms (e.g. as produced by the parser’s * CAPABILITY … data response). Unknown atoms are ignored.

pub fn try_update_from(&mut self, response: &Response<'_>) -> bool

Update from a parsed Response if it carries capabilities — either a * CAPABILITY … data response or a [CAPABILITY …] response code on a status response. Returns true if anything was updated.

pub fn from_frame(frame: &[u8]) -> Option<Self>

Best-effort parse of a raw frame. Returns Some(caps) if the bytes contain a CAPABILITY response (data or response-code); else None.

pub fn parse(response: &str) -> Self

Substring-based parser kept for backward compatibility. Prefer Self::from_atoms or Self::from_frame — those use the real parser and avoid prefix collisions like IMAP4REV2X.

Trait Implementations

impl Clone for Capabilities

fn clone(&self) -> Capabilities

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Capabilities

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

Formats the value using the given formatter.

impl Default for Capabilities

fn default() -> Capabilities

Returns the “default value” for a type.