Enum EmailCommands 

pub enum EmailCommands {
    Authenticate {
        email: String,
        alias: Option<String>,
        provider: Option<Provider>,
        host: Option<String>,
        port: Option<u16>,
    },
    List,
    Sync {
        alias: Option<String>,
        local_output: Option<PathBuf>,
        remote_output: Option<String>,
        debug: Option<DebugPhase>,
        concurrency: usize,
    },
}

Variants

Authenticate

Authenticate an email identity and register it under a local alias

Fields

email: String

Email address of the identity to authenticate, e.g. first.last@example.com

alias: Option<String>

Local alias to store this identity under (e.g. first-last). Defaults to a sanitized form of the email’s local part.

provider: Option<Provider>

Email provider. Auto-detected from the email’s domain when omitted, falling back to an interactive prompt if detection fails.

host: Option<String>

IMAP host, e.g. imap.example.com. Required when –provider is “custom” (or resolves to it); ignored for known providers, which use their own well-known host.

port: Option<u16>

IMAP port. Defaults to 993 for a custom provider when omitted; ignored for known providers, which use their own well-known port.

List

List all locally authenticated email identities

Sync

Download and transform all mail for an authenticated identity in one step

Fields

alias: Option<String>

Alias of the identity to sync, as registered via authenticate. Interactively selected from the authenticated identities when omitted.

local_output: Option<PathBuf>

Local directory to stage raw .eml files under staging/ and write transformed Markdown output under result/. The staging side is transient by default: each message is deleted once its transform is verified. Only persists when –debug sink is used and the default flow is never run against it afterward. Defaults to a per-alias directory under the OS temp directory when omitted.

remote_output: Option<String>

Alias of a configured bucket-config (see pigeon dataops bucket-config new) to upload each synced message’s Markdown and attachments to, in addition to –local-output. Rejected as a usage error when combined with –debug (sink/transform stay local-only).

debug: Option<DebugPhase>

Run only one phase, exactly as it behaved standalone before this command existed: “sink” fetches without transforming; “transform” transforms without fetching. Both are non-destructive (never delete the source .eml).

concurrency: usize

Maximum number of mailboxes to process concurrently. Rejected in combination with –debug, which stays single-mailbox and sequential.

Trait Implementations

impl Debug for EmailCommands

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

Formats the value using the given formatter.

impl FromArgMatches for EmailCommands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for EmailCommands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand