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

//! # Mailbox argument
//!
//! The `-m/--mailbox` flag every shared command targeting one mailbox
//! takes, and the alias resolution behind it.

use clap::Parser;

use crate::{account::context::Account, email::mailbox::MailboxRole};

/// The `-m/--mailbox` flag of a command targeting one mailbox.
#[derive(Clone, Debug, Default, Parser)]
pub struct MailboxArg {
    /// Mailbox name, alias, role or backend-native id.
    ///
    /// The value is looked up against `mailbox.alias` case-insensitively,
    /// then against the mailbox roles the backend knows (inbox, sent,
    /// drafts, trash...), and passed through verbatim when nothing
    /// matches. Omitted, the inbox is used.
    #[arg(short = 'm', long = "mailbox", value_name = "NAME")]
    pub inner: Option<String>,
}

impl MailboxArg {
    /// Resolves the flag through the aliases, the client resolving roles
    /// and names afterwards.
    pub fn resolve(&self, account: &Account) -> String {
        resolve_mailbox_or_default(account, self.inner.as_deref())
    }
}

/// Resolves an optional mailbox name through the aliases, falling back to
/// the inbox.
///
/// An omitted mailbox is the `inbox` alias when set, and the `inbox` role
/// otherwise, which the client maps onto the backend's own inbox.
pub fn resolve_mailbox_or_default(account: &Account, name: Option<&str>) -> String {
    let name = name.unwrap_or(MailboxRole::Inbox.as_str());
    account.resolve_mailbox(name).to_string()
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::config::{Config, MailboxConfig};

    #[test]
    fn omitted_mailbox_is_the_inbox_alias_else_the_inbox_role() {
        let bare = Account::from(Config::default());
        assert_eq!(resolve_mailbox_or_default(&bare, None), "inbox");

        let aliased = Account::from(Config {
            mailbox: MailboxConfig {
                aliases: [("inbox".to_string(), "raw-id".to_string())].into(),
                ..MailboxConfig::default()
            },
            ..Config::default()
        });
        assert_eq!(resolve_mailbox_or_default(&aliased, None), "raw-id");
        assert_eq!(resolve_mailbox_or_default(&aliased, Some("Sent")), "Sent");
    }
}