himalaya 2.2.1

CLI to manage emails
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

//! # Gmail settings conversion
//!
//! Maps the Gmail settings enums to and from their camelCase wire
//! spellings.
//!
//! These are pure CLI affordances, so they live here rather than in
//! io-gmail. Each input enum keeps the wire spelling, so what a `set`
//! accepts is what the paired `get` prints.

use clap::ValueEnum;
use io_gmail::v1::rest::settings::{
    GmailDisposition, GmailExpungeBehavior, GmailPopAccessWindow, GmailVerificationStatus,
};

/// What becomes of a message once it has been forwarded or fetched.
#[derive(Clone, Copy, Debug, ValueEnum)]
#[clap(rename_all = "camelCase")]
pub enum DispositionArg {
    /// Leave it in the inbox, unread.
    LeaveInInbox,
    /// Archive it.
    Archive,
    /// Move it to the trash.
    Trash,
    /// Leave it in the inbox, marked read.
    MarkRead,
}

impl From<DispositionArg> for GmailDisposition {
    fn from(arg: DispositionArg) -> Self {
        match arg {
            DispositionArg::LeaveInInbox => GmailDisposition::LeaveInInbox,
            DispositionArg::Archive => GmailDisposition::Archive,
            DispositionArg::Trash => GmailDisposition::Trash,
            DispositionArg::MarkRead => GmailDisposition::MarkRead,
        }
    }
}

/// What becomes of a message an IMAP client expunges.
#[derive(Clone, Copy, Debug, ValueEnum)]
#[clap(rename_all = "camelCase")]
pub enum ExpungeBehaviorArg {
    /// Archive it.
    Archive,
    /// Move it to the trash.
    Trash,
    /// Delete it for good.
    DeleteForever,
}

impl From<ExpungeBehaviorArg> for GmailExpungeBehavior {
    fn from(arg: ExpungeBehaviorArg) -> Self {
        match arg {
            ExpungeBehaviorArg::Archive => GmailExpungeBehavior::Archive,
            ExpungeBehaviorArg::Trash => GmailExpungeBehavior::Trash,
            ExpungeBehaviorArg::DeleteForever => GmailExpungeBehavior::DeleteForever,
        }
    }
}

/// Which mail a POP client may fetch.
#[derive(Clone, Copy, Debug, ValueEnum)]
#[clap(rename_all = "camelCase")]
pub enum PopAccessWindowArg {
    /// None: POP access is off.
    Disabled,
    /// Only the mail arriving from now on.
    FromNowOn,
    /// Every mail in the mailbox.
    AllMail,
}

impl From<PopAccessWindowArg> for GmailPopAccessWindow {
    fn from(arg: PopAccessWindowArg) -> Self {
        match arg {
            PopAccessWindowArg::Disabled => GmailPopAccessWindow::Disabled,
            PopAccessWindowArg::FromNowOn => GmailPopAccessWindow::FromNowOn,
            PopAccessWindowArg::AllMail => GmailPopAccessWindow::AllMail,
        }
    }
}

/// Folds a `--enable` / `--disable` flag pair into a tri-state:
/// `Some(true)` to enable, `Some(false)` to disable, `None` to leave
/// the current value unchanged. The two flags are mutually exclusive
/// at the clap layer.
pub fn enabled_flag(enable: bool, disable: bool) -> Option<bool> {
    if enable {
        Some(true)
    } else if disable {
        Some(false)
    } else {
        None
    }
}

/// Spell a boolean the way the settings commands display it.
pub fn yes_no(value: bool) -> &'static str {
    if value { "yes" } else { "no" }
}

/// Map a disposition to its Gmail wire spelling for display.
pub fn disposition_wire(disposition: GmailDisposition) -> &'static str {
    match disposition {
        GmailDisposition::DispositionUnspecified => "dispositionUnspecified",
        GmailDisposition::LeaveInInbox => "leaveInInbox",
        GmailDisposition::Archive => "archive",
        GmailDisposition::Trash => "trash",
        GmailDisposition::MarkRead => "markRead",
    }
}

/// Map an expunge behavior to its Gmail wire spelling for display.
pub fn expunge_behavior_wire(behavior: GmailExpungeBehavior) -> &'static str {
    match behavior {
        GmailExpungeBehavior::ExpungeBehaviorUnspecified => "expungeBehaviorUnspecified",
        GmailExpungeBehavior::Archive => "archive",
        GmailExpungeBehavior::Trash => "trash",
        GmailExpungeBehavior::DeleteForever => "deleteForever",
    }
}

/// Map a POP access window to its Gmail wire spelling for display.
pub fn access_window_wire(access_window: GmailPopAccessWindow) -> &'static str {
    match access_window {
        GmailPopAccessWindow::AccessWindowUnspecified => "accessWindowUnspecified",
        GmailPopAccessWindow::Disabled => "disabled",
        GmailPopAccessWindow::FromNowOn => "fromNowOn",
        GmailPopAccessWindow::AllMail => "allMail",
    }
}

/// Map a verification status to its Gmail wire spelling for display.
pub fn verification_status_wire(status: GmailVerificationStatus) -> &'static str {
    match status {
        GmailVerificationStatus::VerificationStatusUnspecified => "verificationStatusUnspecified",
        GmailVerificationStatus::Accepted => "accepted",
        GmailVerificationStatus::Pending => "pending",
        GmailVerificationStatus::Rejected => "rejected",
        GmailVerificationStatus::Expired => "expired",
    }
}