Skip to main content

rmut_core/
command.rs

1//! mutt's enter-command (`:`): config commands typed at runtime.
2//!
3//! Parsing is shared with the muttrc importer (same tokenizer, same
4//! option and color vocabulary), so what `--import-muttrc` understands
5//! in a file is also what `:` understands at the prompt. Applying is
6//! split: everything that is pure [`Config`] state lands in [`apply`],
7//! while binds, macros, aliases, and key pushing belong to the running
8//! TUI and are returned to the caller untouched. A later folder-hook
9//! with arbitrary commands parses the same way and applies the same
10//! [`Config`] half.
11
12use crate::config::{ColorRule, Config};
13use crate::muttrc::{assignments, convert_color, is_yes, split_from, tokenize};
14
15/// Which key table a `bind`/`macro` targets. `Generic` is mutt's
16/// catch-all menu, applied to both of rmut's tables.
17#[derive(Clone, Copy, PartialEq, Eq, Debug)]
18pub enum Menu {
19    Index,
20    Pager,
21    Generic,
22}
23
24impl Menu {
25    fn parse(name: &str) -> Option<Menu> {
26        match name {
27            "index" => Some(Menu::Index),
28            "pager" => Some(Menu::Pager),
29            "generic" => Some(Menu::Generic),
30            _ => None,
31        }
32    }
33
34    pub fn name(self) -> &'static str {
35        match self {
36            Menu::Index => "index",
37            Menu::Pager => "pager",
38            Menu::Generic => "generic",
39        }
40    }
41}
42
43/// One command off the `:` prompt. A single line can yield several
44/// (`set a=1 b=2` is two assignments, like mutt).
45#[derive(Clone, Debug, PartialEq)]
46pub enum Command {
47    Set {
48        name: String,
49        value: String,
50    },
51    Unset(String),
52    Toggle(String),
53    /// `set name?`: report the value instead of changing it.
54    Query(String),
55    Bind {
56        menu: Menu,
57        key: String,
58        function: String,
59    },
60    Macro {
61        menu: Menu,
62        key: String,
63        seq: String,
64    },
65    Color {
66        object: String,
67        fg: String,
68        bg: String,
69        pattern: Option<String>,
70    },
71    Ignore(Vec<String>),
72    Unignore(Vec<String>),
73    /// mutt's uncolor / unmono: drop what a color line put in. `*`
74    /// as the pattern drops every rule of the object.
75    Uncolor {
76        object: String,
77        pattern: Option<String>,
78    },
79    /// mutt's unhook: drop every hook of a type, or all of them (`*`).
80    Unhook(String),
81    /// mutt's unmailboxes: forget watched mailboxes, or all (`*`).
82    Unmailboxes(Vec<String>),
83    /// mutt's unalias: drop aliases from the alias file, or all (`*`).
84    Unalias(Vec<String>),
85    /// mutt's reset: a setting back to its default.
86    Reset(String),
87    /// mutt's `alternates` / `unalternates`: regexes for my other
88    /// addresses (`*` un-does the lot).
89    Alternates(Vec<String>),
90    Unalternates(Vec<String>),
91    /// mutt's `auto_view` / `unauto_view`: MIME types rendered inline
92    /// by a filter. auto_view leaves the command to mailcap (an empty
93    /// [filters] value); `unauto_view *` clears the lot.
94    AutoView(Vec<String>),
95    UnAutoView(Vec<String>),
96    /// mutt's `alternative_order` / `unalternative_order`: which part
97    /// of a multipart/alternative wins (`*` un-does the lot).
98    AlternativeOrder(Vec<String>),
99    UnAlternativeOrder(Vec<String>),
100    /// mutt's `my_hdr`: one "Name: value" line for every draft.
101    MyHdr(String),
102    /// `unmy_hdr NAME...`, or `*` for all of them.
103    UnMyHdr(Vec<String>),
104    Alias {
105        nick: String,
106        expansion: String,
107    },
108    /// Keys fed to the input queue, as a macro sequence.
109    Push(String),
110    /// A function name run directly.
111    Exec(String),
112}
113
114/// Parse one `:` line. An empty line or a comment yields nothing; an
115/// unknown or malformed command is an error string ready for the
116/// status line.
117pub fn parse(line: &str) -> Result<Vec<Command>, String> {
118    let trimmed = line.trim();
119    if trimmed.is_empty() || trimmed.starts_with('#') {
120        return Ok(Vec::new());
121    }
122    let tokens = tokenize(trimmed);
123    let Some(cmd) = tokens.first() else {
124        return Ok(Vec::new());
125    };
126    let args = &tokens[1..];
127    match cmd.as_str() {
128        "set" => {
129            if args.is_empty() {
130                return Err("set what?".into());
131            }
132            Ok(assignments(args).into_iter().map(one_set).collect())
133        }
134        "unset" => want(args, "unset what?").map(|names| {
135            names
136                .iter()
137                .map(|n| Command::Unset(n.to_string()))
138                .collect()
139        }),
140        "reset" => want(args, "reset what?").map(|names| {
141            names
142                .iter()
143                .map(|n| Command::Reset(n.to_string()))
144                .collect()
145        }),
146        "uncolor" | "unmono" => {
147            let Some(object) = args.first() else {
148                return Err(format!("{cmd} OBJECT [PATTERN|*]"));
149            };
150            Ok(vec![Command::Uncolor {
151                object: object.clone(),
152                pattern: (args.len() > 1).then(|| args[1..].join(" ")),
153            }])
154        }
155        "mono" => {
156            // mutt's mono: an attribute where color has a colour pair.
157            // Index and body rules carry it; the rest of the objects
158            // have nowhere to keep one.
159            let (Some(object), Some(attr)) = (args.first(), args.get(1)) else {
160                return Err("mono OBJECT ATTRIBUTE [PATTERN]".into());
161            };
162            if !matches!(
163                attr.as_str(),
164                "none" | "bold" | "underline" | "reverse" | "standout"
165            ) {
166                return Err(format!("mono: no such attribute {attr:?}"));
167            }
168            Ok(vec![Command::Color {
169                object: object.clone(),
170                fg: attr.clone(),
171                bg: "default".into(),
172                pattern: (args.len() > 2).then(|| args[2..].join(" ")),
173            }])
174        }
175        "unhook" => want(args, "unhook TYPE|*").map(|types| {
176            types
177                .iter()
178                .map(|t| Command::Unhook(t.to_string()))
179                .collect()
180        }),
181        "unmailboxes" => {
182            want(args, "unmailboxes MAILBOX...|*").map(|m| vec![Command::Unmailboxes(m)])
183        }
184        "unalias" => want(args, "unalias NICK...|*").map(|n| vec![Command::Unalias(n)]),
185        "toggle" => want(args, "toggle what?").map(|names| {
186            names
187                .iter()
188                .map(|n| Command::Toggle(n.to_string()))
189                .collect()
190        }),
191        "bind" | "macro" => {
192            let (Some(menus), Some(key)) = (args.first(), args.get(1)) else {
193                return Err(format!("{cmd} MENU KEY ..."));
194            };
195            let Some(rest) = args.get(2) else {
196                return Err(if cmd == "bind" {
197                    "bind MENU KEY FUNCTION".into()
198                } else {
199                    "macro MENU KEY SEQUENCE".into()
200                });
201            };
202            let mut out = Vec::new();
203            for name in menus.split(',') {
204                let Some(menu) = Menu::parse(name) else {
205                    return Err(format!("unknown menu {name:?}"));
206                };
207                out.push(if cmd == "bind" {
208                    Command::Bind {
209                        menu,
210                        key: key.clone(),
211                        function: rest.clone(),
212                    }
213                } else {
214                    Command::Macro {
215                        menu,
216                        key: key.clone(),
217                        seq: rest.clone(),
218                    }
219                });
220            }
221            Ok(out)
222        }
223        "color" => {
224            let (Some(object), Some(fg), Some(bg)) = (args.first(), args.get(1), args.get(2))
225            else {
226                return Err("color OBJECT FG BG [PATTERN]".into());
227            };
228            Ok(vec![Command::Color {
229                object: object.clone(),
230                fg: fg.clone(),
231                bg: bg.clone(),
232                // The pattern is the rest of the line: quoting it is
233                // mutt's habit, but an unquoted one still reads whole.
234                pattern: (args.len() > 3).then(|| args[3..].join(" ")),
235            }])
236        }
237        "ignore" => want(args, "ignore which headers?").map(|h| vec![Command::Ignore(h)]),
238        "unignore" => want(args, "unignore which headers?").map(|h| vec![Command::Unignore(h)]),
239        "alternates" => want(args, "alternates PATTERN...").map(|p| vec![Command::Alternates(p)]),
240        "unalternates" => {
241            want(args, "unalternates PATTERN...").map(|p| vec![Command::Unalternates(p)])
242        }
243        "auto_view" => want(args, "auto_view MIMETYPE...").map(|t| vec![Command::AutoView(t)]),
244        "unauto_view" => {
245            want(args, "unauto_view MIMETYPE...").map(|t| vec![Command::UnAutoView(t)])
246        }
247        "alternative_order" => {
248            want(args, "alternative_order MIMETYPE...").map(|t| vec![Command::AlternativeOrder(t)])
249        }
250        "unalternative_order" => want(args, "unalternative_order MIMETYPE...")
251            .map(|t| vec![Command::UnAlternativeOrder(t)]),
252        "my_hdr" => {
253            // The value carries colons and spaces, so it comes off the
254            // raw line rather than from the tokens.
255            let rest = trimmed["my_hdr".len()..].trim().trim_matches('"');
256            if !rest.contains(':') || rest.starts_with(':') {
257                return Err("my_hdr \"Name: value\"".into());
258            }
259            Ok(vec![Command::MyHdr(rest.to_string())])
260        }
261        "unmy_hdr" => want(args, "unmy_hdr NAME...").map(|n| vec![Command::UnMyHdr(n)]),
262        "alias" => {
263            let (Some(nick), rest) = (args.first(), &args[1.min(args.len())..]) else {
264                return Err("alias NICK ADDRESS".into());
265            };
266            if rest.is_empty() {
267                return Err("alias NICK ADDRESS".into());
268            }
269            Ok(vec![Command::Alias {
270                nick: nick.clone(),
271                expansion: rest.join(" "),
272            }])
273        }
274        "push" => {
275            if args.is_empty() {
276                return Err("push what?".into());
277            }
278            Ok(vec![Command::Push(args.join(" "))])
279        }
280        "exec" => {
281            let Some(function) = args.first() else {
282                return Err("exec what?".into());
283            };
284            Ok(vec![Command::Exec(function.clone())])
285        }
286        other => Err(format!("unknown command {other:?}")),
287    }
288}
289
290fn want(args: &[String], msg: &str) -> Result<Vec<String>, String> {
291    if args.is_empty() {
292        Err(msg.to_string())
293    } else {
294        Ok(args.to_vec())
295    }
296}
297
298/// One `set` assignment, decoding mutt's `no`/`inv` prefixes and the
299/// trailing `?` that [`assignments`] leaves on the name.
300fn one_set((name, value): (String, String)) -> Command {
301    if let Some(base) = name.strip_suffix('?') {
302        return Command::Query(base.to_string());
303    }
304    if let Some(base) = name.strip_prefix("inv") {
305        return Command::Toggle(base.to_string());
306    }
307    if value == "no" {
308        return Command::Unset(name);
309    }
310    Command::Set { name, value }
311}
312
313/// A settable option as a mutable handle into the live config.
314enum Slot<'a> {
315    Text(&'a mut Option<String>),
316    Flag(&'a mut bool),
317    FlagOpt(&'a mut Option<bool>),
318    Num16(&'a mut u16),
319    NumUsize(&'a mut usize),
320    NumU64(&'a mut u64),
321    NumU64Opt(&'a mut Option<u64>),
322    NumI64Opt(&'a mut Option<i64>),
323}
324
325/// mutt's option name to the config field it drives. Options whose
326/// value needs decoding first (`from`, `mime_forward`) are handled by
327/// the caller, and anything not listed here is not runtime-settable.
328fn slot<'a>(cfg: &'a mut Config, name: &str) -> Option<Slot<'a>> {
329    use Slot::*;
330    Some(match name {
331        "index_format" => Text(&mut cfg.index.format),
332        "date_format" => Text(&mut cfg.index.date_format),
333        "sort" => Text(&mut cfg.index.sort),
334        "sort_aux" => Text(&mut cfg.index.sort_aux),
335        "pager_format" => Text(&mut cfg.pager.format),
336        "quote_regexp" => Text(&mut cfg.pager.quote_regexp),
337        "status_format" => Text(&mut cfg.ui.status_format),
338        "status_chars" => Text(&mut cfg.ui.status_chars),
339        "ts_status_format" => Text(&mut cfg.ui.title_format),
340        "ts_enabled" => FlagOpt(&mut cfg.ui.set_title),
341        "history_file" => Text(&mut cfg.ui.history_file),
342        "status_on_top" => FlagOpt(&mut cfg.ui.status_on_top),
343        "arrow_cursor" => FlagOpt(&mut cfg.ui.arrow_cursor),
344        "theme" => Text(&mut cfg.ui.theme),
345        "sendmail" => Text(&mut cfg.mail.sendmail),
346        "editor" | "visual" => Text(&mut cfg.mail.editor),
347        "print_command" => Text(&mut cfg.mail.print),
348        "hostname" => Text(&mut cfg.mail.hostname),
349        "sig_on_top" => FlagOpt(&mut cfg.mail.sig_on_top),
350        "user_agent" => FlagOpt(&mut cfg.mail.user_agent),
351        "pipe_sep" => Text(&mut cfg.mail.pipe_sep),
352        "pipe_decode" => FlagOpt(&mut cfg.mail.pipe_decode),
353        "print_decode" => FlagOpt(&mut cfg.mail.print_decode),
354        "pipe_split" => FlagOpt(&mut cfg.mail.pipe_split),
355        "print_split" => FlagOpt(&mut cfg.mail.print_split),
356        "query_command" => Text(&mut cfg.mail.query_command),
357        "trash" => Text(&mut cfg.mail.trash),
358        "record" => Text(&mut cfg.mail.sent),
359        "postponed" => Text(&mut cfg.mail.postponed),
360        "new_mail_command" => Text(&mut cfg.mail.new_mail_command),
361        "forward" => Text(&mut cfg.mail.forward),
362        "realname" => Text(&mut cfg.identity.name),
363        "pgp_sign_as" | "pgp_default_key" => Text(&mut cfg.pgp.sign_key),
364        "crypt_replysign" => Flag(&mut cfg.pgp.reply_sign),
365        "crypt_replyencrypt" => Flag(&mut cfg.pgp.reply_encrypt),
366        "crypt_replysignencrypted" => Flag(&mut cfg.pgp.reply_sign_encrypted),
367        "fast_reply" => Flag(&mut cfg.mail.fast_reply),
368        "askcc" => Flag(&mut cfg.mail.ask_cc),
369        "confirmappend" => Flag(&mut cfg.mail.confirmappend),
370        "save_name" => Flag(&mut cfg.mail.save_name),
371        "force_name" => Flag(&mut cfg.mail.force_name),
372        "quit" => Text(&mut cfg.mail.quit),
373        "postpone" => Text(&mut cfg.mail.postpone),
374        "recall" => Text(&mut cfg.mail.recall),
375        "askbcc" => Flag(&mut cfg.mail.ask_bcc),
376        "attribution" => Text(&mut cfg.mail.attribution),
377        "indent_string" => Text(&mut cfg.mail.indent_string),
378        "forward_format" => Text(&mut cfg.mail.forward_format),
379        "reply_regexp" => Text(&mut cfg.mail.reply_regexp),
380        "simple_search" => Text(&mut cfg.mail.simple_search),
381        "wrap_search" => FlagOpt(&mut cfg.mail.wrap_search),
382        "include" => Text(&mut cfg.mail.include),
383        "forward_quote" => Flag(&mut cfg.mail.forward_quote),
384        "signature" => Text(&mut cfg.mail.signature),
385        "sig_dashes" => FlagOpt(&mut cfg.mail.sig_dashes),
386        "abort_nosubject" => Text(&mut cfg.mail.abort_nosubject),
387        "abort_unmodified" => FlagOpt(&mut cfg.mail.abort_unmodified),
388        "autoedit" => Flag(&mut cfg.mail.autoedit),
389        "beep" => Flag(&mut cfg.ui.beep),
390        "beep_new" => Flag(&mut cfg.ui.beep_new),
391        "wait_key" => FlagOpt(&mut cfg.ui.wait_key),
392        "mark_old" => FlagOpt(&mut cfg.mail.mark_old),
393        "delete_untag" => FlagOpt(&mut cfg.mail.delete_untag),
394        "flag_safe" => Flag(&mut cfg.mail.flag_safe),
395        "maildir_trash" => Flag(&mut cfg.mail.maildir_trash),
396        "mail_check_recent" => FlagOpt(&mut cfg.mail.mail_check_recent),
397        "check_new" => FlagOpt(&mut cfg.mail.check_new),
398        "uncollapse_new" => FlagOpt(&mut cfg.index.uncollapse_new),
399        "menu_scroll" => FlagOpt(&mut cfg.ui.menu_scroll),
400        "menu_context" => NumUsize(&mut cfg.ui.menu_context),
401        "menu_move_off" => FlagOpt(&mut cfg.ui.menu_move_off),
402        "help" => FlagOpt(&mut cfg.ui.help),
403        "error_history" => NumUsize(&mut cfg.ui.error_history),
404        "sort_browser" => Text(&mut cfg.ui.sort_browser),
405        "sort_alias" => Text(&mut cfg.mail.sort_alias),
406        "shell" => Text(&mut cfg.mail.shell),
407        "ispell" => Text(&mut cfg.mail.ispell),
408        "tmpdir" => Text(&mut cfg.mail.tmpdir),
409        "print" => Text(&mut cfg.mail.print_confirm),
410        "reverse_realname" => FlagOpt(&mut cfg.identity.reverse_realname),
411        "tilde" => Flag(&mut cfg.pager.tilde),
412        "pager_stop" => Flag(&mut cfg.pager.pager_stop),
413        "markers" => FlagOpt(&mut cfg.pager.markers),
414        "smart_wrap" => FlagOpt(&mut cfg.pager.smart_wrap),
415        "collapse_unread" => FlagOpt(&mut cfg.index.collapse_unread),
416        "hide_thread_subject" => FlagOpt(&mut cfg.index.hide_thread_subject),
417        "strict_threads" => FlagOpt(&mut cfg.index.strict_threads),
418        "sort_re" => FlagOpt(&mut cfg.index.sort_re),
419        "uncollapse_jump" => Flag(&mut cfg.index.uncollapse_jump),
420        "reverse_name" => Flag(&mut cfg.identity.reverse_name),
421        "metoo" => Flag(&mut cfg.mail.metoo),
422        "text_flowed" => Flag(&mut cfg.mail.text_flowed),
423        "reflow_text" => FlagOpt(&mut cfg.pager.reflow_text),
424        "sidebar_visible" => Flag(&mut cfg.sidebar.visible),
425        "crypt_autosign" | "pgp_autosign" => Flag(&mut cfg.pgp.sign_by_default),
426        "crypt_autoencrypt" | "pgp_autoencrypt" => Flag(&mut cfg.pgp.encrypt_by_default),
427        "edit_headers" => FlagOpt(&mut cfg.mail.edit_headers),
428        "copy" => FlagOpt(&mut cfg.mail.copy),
429        "notmuch" => FlagOpt(&mut cfg.mail.notmuch),
430        "pager_index_lines" => Num16(&mut cfg.pager.index_lines),
431        "sidebar_width" => Num16(&mut cfg.sidebar.width),
432        "pager_context" => NumUsize(&mut cfg.pager.context),
433        "search_context" => NumUsize(&mut cfg.pager.search_context),
434        "mail_check" => NumU64Opt(&mut cfg.mail.poll_seconds),
435        "undo_send" => NumU64(&mut cfg.mail.undo_send),
436        "connect_timeout" => NumU64(&mut cfg.net.connect_timeout),
437        "net_timeout" => NumU64(&mut cfg.net.timeout),
438        "delete" => Text(&mut cfg.mail.delete),
439        "abort_noattach" => Text(&mut cfg.mail.abort_noattach),
440        "abort_noattach_regex" => Text(&mut cfg.mail.attach_keyword),
441        "wrap" => NumI64Opt(&mut cfg.pager.wrap),
442        // mutt's older name for use_envelope_from is envelope_from.
443        "use_envelope_from" | "envelope_from" => Flag(&mut cfg.mail.use_envelope_from),
444        "envelope_from_address" => Text(&mut cfg.mail.envelope_from_address),
445        "dsn_notify" => Text(&mut cfg.mail.dsn_notify),
446        "dsn_return" => Text(&mut cfg.mail.dsn_return),
447        "reply_self" => Flag(&mut cfg.mail.reply_self),
448        "fcc_attach" => Text(&mut cfg.mail.fcc_attach),
449        "fcc_clear" => Flag(&mut cfg.mail.fcc_clear),
450        "forward_edit" => Text(&mut cfg.mail.forward_edit),
451        "mime_forward_rest" => FlagOpt(&mut cfg.mail.mime_forward_rest),
452        _ => return None,
453    })
454}
455
456/// Sort orders the index understands, shared by `set sort` and the
457/// config loader's own vocabulary.
458const SORTS: [&str; 5] = ["date", "from", "subject", "size", "threads"];
459
460/// Apply the [`Config`] half of a command. `Ok(Some(text))` is a
461/// message for the status line (a query's answer); `Ok(None)` is a
462/// silent success, mutt-style. Commands the TUI owns (bind, macro,
463/// alias, push, exec) return `Ok(None)` without touching the config,
464/// so the caller must handle those itself.
465pub fn apply(cfg: &mut Config, cmd: &Command) -> Result<Option<String>, String> {
466    match cmd {
467        Command::Set { name, value } => set(cfg, name, value).map(|()| None),
468        Command::Unset(name) => unset(cfg, name).map(|()| None),
469        Command::Reset(name) => reset(cfg, name).map(|()| None),
470        Command::Uncolor { object, pattern } => {
471            uncolor(cfg, object, pattern.as_deref()).map(|()| None)
472        }
473        Command::Unhook(kind) => unhook(cfg, kind).map(|()| None),
474        Command::Unmailboxes(specs) => {
475            if specs.iter().any(|s| s == "*") {
476                cfg.mail.mailboxes.clear();
477            } else {
478                cfg.mail
479                    .mailboxes
480                    .retain(|m| !specs.iter().any(|s| same_mailbox(s, m)));
481            }
482            Ok(None)
483        }
484
485        Command::Toggle(name) => toggle(cfg, name).map(|()| None),
486        Command::Query(name) => query(cfg, name).map(Some),
487        Command::Color {
488            object,
489            fg,
490            bg,
491            pattern,
492        } => color(cfg, object, fg, bg, pattern.as_deref()).map(|()| None),
493        Command::Ignore(headers) => {
494            edit_header_list(cfg, headers, true);
495            Ok(None)
496        }
497        Command::Unignore(headers) => {
498            edit_header_list(cfg, headers, false);
499            Ok(None)
500        }
501        Command::Alternates(patterns) => {
502            for p in patterns {
503                if !cfg.mail.alternates.contains(p) {
504                    cfg.mail.alternates.push(p.clone());
505                }
506            }
507            Ok(None)
508        }
509        Command::Unalternates(patterns) => {
510            for p in patterns {
511                if p == "*" {
512                    cfg.mail.alternates.clear();
513                } else {
514                    cfg.mail.alternates.retain(|a| a != p);
515                }
516            }
517            Ok(None)
518        }
519        Command::AutoView(types) => {
520            for t in types {
521                // The command comes from mailcap, like mutt; a
522                // [filters] entry set by hand is left alone.
523                cfg.filters.entry(t.to_lowercase()).or_default();
524            }
525            Ok(None)
526        }
527        Command::UnAutoView(types) => {
528            for t in types {
529                if t == "*" {
530                    cfg.filters.clear();
531                } else {
532                    cfg.filters.remove(&t.to_lowercase());
533                }
534            }
535            Ok(None)
536        }
537        Command::AlternativeOrder(types) => {
538            for t in types {
539                let t = t.to_lowercase();
540                if !cfg.pager.alternative_order.contains(&t) {
541                    cfg.pager.alternative_order.push(t);
542                }
543            }
544            Ok(None)
545        }
546        Command::UnAlternativeOrder(types) => {
547            for t in types {
548                if t == "*" {
549                    cfg.pager.alternative_order.clear();
550                } else {
551                    let t = t.to_lowercase();
552                    cfg.pager.alternative_order.retain(|a| *a != t);
553                }
554            }
555            Ok(None)
556        }
557        Command::MyHdr(entry) => {
558            // One my_hdr per header name, like mutt: a second line for
559            // the same header replaces the first.
560            if let Some((name, _)) = entry.split_once(':') {
561                let name = name.trim().to_string();
562                cfg.mail.my_hdr.retain(|h| !header_named(h, &name));
563            }
564            cfg.mail.my_hdr.push(entry.clone());
565            Ok(None)
566        }
567        Command::UnMyHdr(names) => {
568            for name in names {
569                if name == "*" {
570                    cfg.mail.my_hdr.clear();
571                } else {
572                    let name = name.trim_end_matches(':');
573                    cfg.mail.my_hdr.retain(|h| !header_named(h, name));
574                }
575            }
576            Ok(None)
577        }
578        Command::Bind { .. }
579        | Command::Macro { .. }
580        | Command::Alias { .. }
581        | Command::Unalias(_)
582        | Command::Push(_)
583        | Command::Exec(_) => Ok(None),
584    }
585}
586
587/// True when a stored `my_hdr` line carries this header name.
588fn header_named(entry: &str, name: &str) -> bool {
589    entry
590        .split_once(':')
591        .is_some_and(|(k, _)| k.trim().eq_ignore_ascii_case(name))
592}
593
594fn unknown(name: &str) -> String {
595    format!("unknown or read-only option {name:?}")
596}
597
598fn set(cfg: &mut Config, name: &str, value: &str) -> Result<(), String> {
599    // mutt's from carries an optional display name; mime_forward is a
600    // boolean spelling of rmut's forward mode.
601    match name {
602        "from" => {
603            let (display, addr) = split_from(value);
604            if let Some(display) = display {
605                cfg.identity.name = Some(display);
606            }
607            cfg.identity.email = Some(addr);
608            return Ok(());
609        }
610        "mime_forward" => {
611            cfg.mail.forward = Some(if is_yes(value) { "attach" } else { "inline" }.into());
612            return Ok(());
613        }
614        _ => {}
615    }
616    if name == "sort" || name == "sort_aux" {
617        let base = value.strip_prefix("reverse-").unwrap_or(value);
618        let known = if name == "sort" {
619            SORTS.contains(&base)
620        } else {
621            base == "last-date-sent" || base == "date"
622        };
623        if !known {
624            return Err(format!("no such sort order {value:?}"));
625        }
626    }
627    let num = |v: &str| -> Result<i64, String> {
628        v.parse::<i64>()
629            .map_err(|_| format!("{name} wants a number, got {v:?}"))
630    };
631    match slot(cfg, name).ok_or_else(|| unknown(name))? {
632        Slot::Text(field) => *field = Some(value.to_string()),
633        Slot::Flag(field) => *field = is_yes(value),
634        Slot::FlagOpt(field) => *field = Some(is_yes(value)),
635        Slot::Num16(field) => *field = u16::try_from(num(value)?.max(0)).unwrap_or(u16::MAX),
636        Slot::NumUsize(field) => *field = usize::try_from(num(value)?.max(0)).unwrap_or(0),
637        Slot::NumU64(field) => *field = num(value)?.max(0) as u64,
638        Slot::NumU64Opt(field) => *field = Some(num(value)?.max(0) as u64),
639        Slot::NumI64Opt(field) => *field = Some(num(value)?),
640    }
641    Ok(())
642}
643
644/// `unset`: booleans go false, everything else goes back to rmut's
645/// built-in default (an unset field), which is what a muttrc-less
646/// session would have used.
647fn unset(cfg: &mut Config, name: &str) -> Result<(), String> {
648    if name == "from" {
649        cfg.identity.email = None;
650        return Ok(());
651    }
652    // A quadoption whose default is yes: unset means no, as in mutt,
653    // not back to the default.
654    let quad = match name {
655        "fcc_attach" => Some(&mut cfg.mail.fcc_attach),
656        "forward_edit" => Some(&mut cfg.mail.forward_edit),
657        _ => None,
658    };
659    if let Some(field) = quad {
660        *field = Some("no".into());
661        return Ok(());
662    }
663    match slot(cfg, name).ok_or_else(|| unknown(name))? {
664        Slot::Text(field) => *field = None,
665        Slot::Flag(field) => *field = false,
666        Slot::FlagOpt(field) => *field = Some(false),
667        Slot::Num16(field) => *field = 0,
668        Slot::NumUsize(field) => *field = 0,
669        Slot::NumU64(field) => *field = 0,
670        Slot::NumU64Opt(field) => *field = None,
671        Slot::NumI64Opt(field) => *field = None,
672    }
673    Ok(())
674}
675
676/// mutt's reset: the setting as a fresh Config has it.
677fn reset(cfg: &mut Config, name: &str) -> Result<(), String> {
678    if name == "all" {
679        return Err("reset all: reload the config instead".into());
680    }
681    if name == "from" {
682        cfg.identity.email = None;
683        return Ok(());
684    }
685    let mut fresh = Config::default();
686    // Read the default out first: two slots into two configs, one at
687    // a time, so neither borrow outlives its use.
688    enum Val {
689        Text(Option<String>),
690        Flag(bool),
691        FlagOpt(Option<bool>),
692        N16(u16),
693        NUsize(usize),
694        NU64(u64),
695        NU64Opt(Option<u64>),
696        NI64Opt(Option<i64>),
697    }
698    let value = match slot(&mut fresh, name).ok_or_else(|| unknown(name))? {
699        Slot::Text(f) => Val::Text(f.clone()),
700        Slot::Flag(f) => Val::Flag(*f),
701        Slot::FlagOpt(f) => Val::FlagOpt(*f),
702        Slot::Num16(f) => Val::N16(*f),
703        Slot::NumUsize(f) => Val::NUsize(*f),
704        Slot::NumU64(f) => Val::NU64(*f),
705        Slot::NumU64Opt(f) => Val::NU64Opt(*f),
706        Slot::NumI64Opt(f) => Val::NI64Opt(*f),
707    };
708    match (slot(cfg, name).ok_or_else(|| unknown(name))?, value) {
709        (Slot::Text(f), Val::Text(v)) => *f = v,
710        (Slot::Flag(f), Val::Flag(v)) => *f = v,
711        (Slot::FlagOpt(f), Val::FlagOpt(v)) => *f = v,
712        (Slot::Num16(f), Val::N16(v)) => *f = v,
713        (Slot::NumUsize(f), Val::NUsize(v)) => *f = v,
714        (Slot::NumU64(f), Val::NU64(v)) => *f = v,
715        (Slot::NumU64Opt(f), Val::NU64Opt(v)) => *f = v,
716        (Slot::NumI64Opt(f), Val::NI64Opt(v)) => *f = v,
717        _ => unreachable!("the same name names the same slot"),
718    }
719    Ok(())
720}
721
722/// mutt's uncolor / unmono, undoing what [`color`] did with the same
723/// object: rules by pattern (or all of them with `*`), the named
724/// slots outright.
725fn uncolor(cfg: &mut Config, object: &str, pattern: Option<&str>) -> Result<(), String> {
726    let mut drop = |keys: &[&str]| {
727        for key in keys {
728            cfg.colors.remove(*key);
729        }
730    };
731    if let Some(n) = object.strip_prefix("quoted")
732        && (n.is_empty() || n.parse::<usize>().is_ok())
733    {
734        let key = if n.is_empty() {
735            "quoted".to_string()
736        } else {
737            format!("quoted{n}")
738        };
739        cfg.colors.remove(&key);
740        return Ok(());
741    }
742    match (object, pattern) {
743        ("status", _) => drop(&["status_fg", "status_bg"]),
744        ("search", _) => drop(&["search_fg", "search_bg"]),
745        ("header" | "hdrdefault", _) => drop(&["header"]),
746        ("error", _) => drop(&["error"]),
747        ("index", Some("*")) => {
748            drop(&["deleted", "flagged", "tagged"]);
749            cfg.color_index.clear();
750        }
751        ("index", Some("~D")) => drop(&["deleted"]),
752        ("index", Some("~F")) => drop(&["flagged"]),
753        ("index", Some("~T")) => drop(&["tagged"]),
754        ("index", Some(pattern)) => cfg.color_index.retain(|r| r.pattern != pattern),
755        ("body", Some("*")) => cfg.color_body.clear(),
756        ("body", Some(pattern)) => cfg.color_body.retain(|r| r.pattern != pattern),
757        ("index" | "body", None) => return Err(format!("uncolor {object} needs a pattern or *")),
758        _ => return Err(format!("no rmut color slot for {object:?}")),
759    }
760    Ok(())
761}
762
763/// mutt's unhook: every hook of one type, or all of them.
764fn unhook(cfg: &mut Config, kind: &str) -> Result<(), String> {
765    match kind {
766        "*" => {
767            cfg.folder_hooks.clear();
768            cfg.message_hooks.clear();
769            cfg.reply_hooks.clear();
770            cfg.fcc_hooks.clear();
771            cfg.crypt_hooks.clear();
772        }
773        "folder-hook" => cfg.folder_hooks.clear(),
774        "message-hook" => cfg.message_hooks.clear(),
775        "reply-hook" => cfg.reply_hooks.clear(),
776        "fcc-hook" => cfg.fcc_hooks.clear(),
777        "crypt-hook" => cfg.crypt_hooks.clear(),
778        other => {
779            return Err(format!(
780                "unhook: unknown hook type: {other} (folder-hook, message-hook, reply-hook, fcc-hook, crypt-hook, *)"
781            ));
782        }
783    }
784    Ok(())
785}
786
787/// Whether two mailbox spellings name the same mailbox: as written,
788/// or with a trailing slash more or less.
789fn same_mailbox(a: &str, b: &str) -> bool {
790    a.trim_end_matches('/') == b.trim_end_matches('/')
791}
792
793fn toggle(cfg: &mut Config, name: &str) -> Result<(), String> {
794    match slot(cfg, name).ok_or_else(|| unknown(name))? {
795        Slot::Flag(field) => *field = !*field,
796        Slot::FlagOpt(field) => *field = Some(!field.unwrap_or(false)),
797        _ => return Err(format!("{name} is not a boolean")),
798    }
799    Ok(())
800}
801
802fn query(cfg: &mut Config, name: &str) -> Result<String, String> {
803    if name == "from" {
804        let value = cfg.identity.email.clone().unwrap_or_default();
805        return Ok(format!("from=\"{value}\""));
806    }
807    let text = match slot(cfg, name).ok_or_else(|| unknown(name))? {
808        Slot::Text(field) => format!("{name}=\"{}\"", field.clone().unwrap_or_default()),
809        Slot::Flag(field) => flag_text(name, *field),
810        Slot::FlagOpt(field) => flag_text(name, field.unwrap_or(false)),
811        Slot::Num16(field) => format!("{name}={field}"),
812        Slot::NumUsize(field) => format!("{name}={field}"),
813        Slot::NumU64(field) => format!("{name}={field}"),
814        Slot::NumU64Opt(field) => match field {
815            Some(n) => format!("{name}={n}"),
816            None => format!("{name} is unset"),
817        },
818        Slot::NumI64Opt(field) => match field {
819            Some(n) => format!("{name}={n}"),
820            None => format!("{name} is unset"),
821        },
822    };
823    Ok(text)
824}
825
826fn flag_text(name: &str, on: bool) -> String {
827    if on {
828        name.to_string()
829    } else {
830        format!("no{name}")
831    }
832}
833
834/// `ignore`/`unignore`: rmut keeps both lists, so each command adds to
835/// its own and drops the name from the other (mutt's unignore is the
836/// same undo, expressed against one list).
837fn edit_header_list(cfg: &mut Config, headers: &[String], ignoring: bool) {
838    let clean: Vec<String> = headers
839        .iter()
840        .map(|h| h.trim_end_matches(':').to_lowercase())
841        .collect();
842    let (add, remove) = if ignoring {
843        (&mut cfg.pager.ignore, &mut cfg.pager.unignore)
844    } else {
845        (&mut cfg.pager.unignore, &mut cfg.pager.ignore)
846    };
847    let list = add.get_or_insert_with(Vec::new);
848    for name in &clean {
849        if !list.contains(name) {
850            list.push(name.clone());
851        }
852    }
853    if let Some(list) = remove {
854        list.retain(|n| !clean.contains(n));
855    }
856}
857
858/// `color OBJECT FG BG [PATTERN]`, with the importer's slot mapping:
859/// named slots land in `[colors]`, index patterns become
860/// `[[color_index]]` rules, and body regexes `[[color_body]]`.
861fn color(
862    cfg: &mut Config,
863    object: &str,
864    fg: &str,
865    bg: &str,
866    pattern: Option<&str>,
867) -> Result<(), String> {
868    let fg = convert_color(fg);
869    let bg = convert_color(bg);
870    // A foreground saying nothing (black/white/default over a colored
871    // background) means the background is the visible color.
872    let vivid = if matches!(fg.as_str(), "black" | "white" | "default") && bg != "default" {
873        bg.clone()
874    } else {
875        fg.clone()
876    };
877    if let Some(n) = object.strip_prefix("quoted")
878        && let Ok(depth) = if n.is_empty() { Ok(0usize) } else { n.parse() }
879    {
880        let key = if depth == 0 {
881            "quoted".to_string()
882        } else {
883            format!("quoted{depth}")
884        };
885        cfg.colors.insert(key, vivid);
886        return Ok(());
887    }
888    let mut named = |key: &str, value: String| {
889        cfg.colors.insert(key.to_string(), value);
890    };
891    match (object, pattern) {
892        ("status", _) => {
893            named("status_fg", fg);
894            named("status_bg", bg);
895        }
896        ("search", _) => {
897            if fg != "default" {
898                named("search_fg", fg);
899            }
900            if bg != "default" {
901                named("search_bg", bg);
902            }
903        }
904        ("header" | "hdrdefault", _) => named("header", fg),
905        ("error", _) => named("error", vivid),
906        // One colour goes to the built-in slot; a line that paints a
907        // background as well keeps both, as a [[color_index]] rule.
908        ("index", Some("~D")) if bg == "default" => named("deleted", vivid),
909        ("index", Some("~F")) if bg == "default" => named("flagged", vivid),
910        ("index", Some("~T")) if bg == "default" => named("tagged", vivid),
911        ("index", Some(pattern)) => {
912            crate::pattern::parse(pattern).map_err(|err| format!("bad pattern: {err}"))?;
913            cfg.color_index.push(rule(pattern, fg, bg));
914        }
915        ("body", Some(pattern)) => {
916            regex_lite::Regex::new(pattern).map_err(|err| format!("bad regex: {err}"))?;
917            cfg.color_body.push(rule(pattern, fg, bg));
918        }
919        ("index" | "body", None) => return Err(format!("color {object} needs a pattern")),
920        _ => return Err(format!("no rmut color slot for {object:?}")),
921    }
922    Ok(())
923}
924
925fn rule(pattern: &str, fg: String, bg: String) -> ColorRule {
926    ColorRule {
927        pattern: pattern.to_string(),
928        fg: (fg != "default").then_some(fg),
929        bg: (bg != "default").then_some(bg),
930    }
931}
932
933#[cfg(test)]
934mod tests {
935    use super::*;
936
937    fn one(line: &str) -> Command {
938        let mut cmds = parse(line).expect("parses");
939        assert_eq!(cmds.len(), 1, "{line:?} yielded {cmds:?}");
940        cmds.pop().unwrap()
941    }
942
943    #[test]
944    fn alternates_and_my_hdr_at_the_prompt() {
945        let mut cfg = Config::default();
946        for line in [
947            "alternates jane@old\\.example\\.com typo@x",
948            "unalternates typo@x",
949            "my_hdr Organization: Acme",
950            "my_hdr X-Mailer: rmut",
951            "my_hdr Organization: Acme Ltd",
952            "unmy_hdr X-Mailer",
953            "set metoo",
954        ] {
955            for cmd in parse(line).expect(line) {
956                apply(&mut cfg, &cmd).expect(line);
957            }
958        }
959        assert_eq!(cfg.mail.alternates, ["jane@old\\.example\\.com"]);
960        assert_eq!(cfg.mail.my_hdr, ["Organization: Acme Ltd"]);
961        assert!(cfg.mail.metoo);
962        for cmd in parse("unmy_hdr *").unwrap() {
963            apply(&mut cfg, &cmd).unwrap();
964        }
965        assert!(cfg.mail.my_hdr.is_empty());
966        assert!(parse("my_hdr Organization").is_err());
967        assert!(parse("alternates").is_err());
968    }
969
970    #[test]
971    fn envelope_options_at_the_prompt() {
972        let mut cfg = Config::default();
973        for line in [
974            "set envelope_from",
975            "set envelope_from_address=\"Bounces <bounces@example.com>\"",
976            "set dsn_notify=failure,delay dsn_return=hdrs",
977            "set reply_self fcc_clear",
978            "unset fcc_attach",
979            "unset forward_edit",
980            "set mime_forward_rest=no",
981        ] {
982            for cmd in parse(line).expect(line) {
983                apply(&mut cfg, &cmd).expect(line);
984            }
985        }
986        let mail = &cfg.mail;
987        assert!(mail.use_envelope_from && mail.reply_self && mail.fcc_clear);
988        assert_eq!(mail.fcc_attach.as_deref(), Some("no"));
989        assert_eq!(mail.forward_edit.as_deref(), Some("no"));
990        assert_eq!(mail.mime_forward_rest, Some(false));
991        let envelope = mail.envelope("jane@example.com");
992        assert_eq!(envelope.sender.as_deref(), Some("bounces@example.com"));
993        assert_eq!(envelope.notify.as_deref(), Some("failure,delay"));
994        assert_eq!(envelope.ret.as_deref(), Some("hdrs"));
995        // Without an address of its own the envelope sender is the From;
996        // with use_envelope_from off nobody insists on one.
997        cfg.mail.envelope_from_address = None;
998        let from = cfg.mail.envelope("jane@example.com").sender;
999        assert_eq!(from.as_deref(), Some("jane@example.com"));
1000        cfg.mail.use_envelope_from = false;
1001        assert_eq!(cfg.mail.envelope("jane@example.com").sender, None);
1002    }
1003
1004    #[test]
1005    fn auto_view_and_alternative_order_at_the_prompt() {
1006        let mut cfg = Config::default();
1007        for line in [
1008            "auto_view text/html Application/Zip",
1009            "auto_view text/calendar",
1010            "unauto_view text/calendar",
1011            "alternative_order text/plain TEXT/HTML",
1012            "alternative_order text/plain",
1013            "unalternative_order text/html",
1014        ] {
1015            for cmd in parse(line).expect(line) {
1016                apply(&mut cfg, &cmd).expect(line);
1017            }
1018        }
1019        // auto_view leaves the command to mailcap: an empty value.
1020        let mut types: Vec<&str> = cfg.filters.keys().map(String::as_str).collect();
1021        types.sort_unstable();
1022        assert_eq!(types, ["application/zip", "text/html"]);
1023        assert!(cfg.filters.values().all(String::is_empty));
1024        // A command set by hand survives a later auto_view for the type.
1025        cfg.filters
1026            .insert("text/html".into(), "w3m -dump -T text/html".into());
1027        for cmd in parse("auto_view text/html").unwrap() {
1028            apply(&mut cfg, &cmd).unwrap();
1029        }
1030        assert_eq!(
1031            cfg.filters.get("text/html").map(String::as_str),
1032            Some("w3m -dump -T text/html")
1033        );
1034        // The order keeps its first mention and drops duplicates.
1035        assert_eq!(cfg.pager.alternative_order, ["text/plain"]);
1036        for cmd in parse("unauto_view *").unwrap() {
1037            apply(&mut cfg, &cmd).unwrap();
1038        }
1039        assert!(cfg.filters.is_empty());
1040        assert!(parse("auto_view").is_err());
1041        assert!(parse("alternative_order").is_err());
1042    }
1043
1044    #[test]
1045    fn set_forms() {
1046        assert_eq!(
1047            one("set index_format=\"%s %f\""),
1048            Command::Set {
1049                name: "index_format".into(),
1050                value: "%s %f".into()
1051            }
1052        );
1053        assert_eq!(one("set nobeep"), Command::Unset("beep".into()));
1054        assert_eq!(
1055            one("set beep"),
1056            Command::Set {
1057                name: "beep".into(),
1058                value: "yes".into()
1059            }
1060        );
1061        assert_eq!(one("set invbeep"), Command::Toggle("beep".into()));
1062        assert_eq!(one("set beep?"), Command::Query("beep".into()));
1063        assert_eq!(one("toggle tilde"), Command::Toggle("tilde".into()));
1064        assert_eq!(one("unset tilde"), Command::Unset("tilde".into()));
1065        assert_eq!(parse("set a=1 b=2").unwrap().len(), 2);
1066        assert_eq!(parse("").unwrap(), vec![]);
1067        assert_eq!(parse("# comment").unwrap(), vec![]);
1068    }
1069
1070    #[test]
1071    fn unknown_command_and_option_report() {
1072        assert!(parse("frobnicate x").is_err());
1073        let mut cfg = Config::default();
1074        let err = apply(&mut cfg, &one("set nosuchthing=1")).unwrap_err();
1075        assert!(err.contains("nosuchthing"), "{err}");
1076    }
1077
1078    #[test]
1079    fn set_applies_to_config() {
1080        let mut cfg = Config::default();
1081        apply(&mut cfg, &one("set pager_index_lines=5")).unwrap();
1082        assert_eq!(cfg.pager.index_lines, 5);
1083        apply(&mut cfg, &one("set wrap=-8")).unwrap();
1084        assert_eq!(cfg.pager.wrap, Some(-8));
1085        apply(&mut cfg, &one("set tilde")).unwrap();
1086        assert!(cfg.pager.tilde);
1087        apply(&mut cfg, &one("toggle tilde")).unwrap();
1088        assert!(!cfg.pager.tilde);
1089        apply(&mut cfg, &one("set from=\"Jane Doe <jane@x>\"")).unwrap();
1090        assert_eq!(cfg.identity.email.as_deref(), Some("jane@x"));
1091        assert_eq!(cfg.identity.name.as_deref(), Some("Jane Doe"));
1092        // Numbers and sort orders are checked, not silently accepted.
1093        assert!(apply(&mut cfg, &one("set pager_index_lines=x")).is_err());
1094        assert!(apply(&mut cfg, &one("set sort=nonsense")).is_err());
1095        apply(&mut cfg, &one("set sort=reverse-date")).unwrap();
1096        assert_eq!(cfg.index.sort.as_deref(), Some("reverse-date"));
1097    }
1098
1099    #[test]
1100    fn query_reports_current_value() {
1101        let mut cfg = Config::default();
1102        cfg.index.format = Some("%s".into());
1103        let out = apply(&mut cfg, &one("set index_format?")).unwrap();
1104        assert_eq!(out.as_deref(), Some("index_format=\"%s\""));
1105        let out = apply(&mut cfg, &one("set beep?")).unwrap();
1106        assert_eq!(out.as_deref(), Some("beep"));
1107        apply(&mut cfg, &one("unset beep")).unwrap();
1108        let out = apply(&mut cfg, &one("set beep?")).unwrap();
1109        assert_eq!(out.as_deref(), Some("nobeep"));
1110    }
1111
1112    #[test]
1113    fn ignore_lists_move_names_between_them() {
1114        let mut cfg = Config::default();
1115        apply(&mut cfg, &one("ignore x-spam: received")).unwrap();
1116        assert_eq!(
1117            cfg.pager.ignore.as_deref(),
1118            Some(["x-spam".to_string(), "received".to_string()].as_slice())
1119        );
1120        apply(&mut cfg, &one("unignore received")).unwrap();
1121        assert_eq!(
1122            cfg.pager.ignore.as_deref(),
1123            Some(["x-spam".to_string()].as_slice())
1124        );
1125        assert_eq!(
1126            cfg.pager.unignore.as_deref(),
1127            Some(["received".to_string()].as_slice())
1128        );
1129    }
1130
1131    #[test]
1132    fn colors_land_in_their_slots() {
1133        let mut cfg = Config::default();
1134        apply(&mut cfg, &one("color status brightwhite blue")).unwrap();
1135        assert_eq!(
1136            cfg.colors.get("status_fg").map(String::as_str),
1137            Some("lightwhite")
1138        );
1139        assert_eq!(
1140            cfg.colors.get("status_bg").map(String::as_str),
1141            Some("blue")
1142        );
1143        apply(&mut cfg, &one("color quoted2 green default")).unwrap();
1144        assert_eq!(cfg.colors.get("quoted2").map(String::as_str), Some("green"));
1145        apply(&mut cfg, &one("color index red default ~F")).unwrap();
1146        assert_eq!(cfg.colors.get("flagged").map(String::as_str), Some("red"));
1147        apply(&mut cfg, &one("color index red default ~f jane")).unwrap();
1148        assert_eq!(cfg.color_index.len(), 1);
1149        apply(&mut cfg, &one("color body yellow default TODO")).unwrap();
1150        assert_eq!(cfg.color_body.len(), 1);
1151        // A pattern or regex that does not compile is refused.
1152        assert!(apply(&mut cfg, &one("color index red default ~q")).is_err());
1153        assert!(apply(&mut cfg, &one("color body red default [")).is_err());
1154        assert!(apply(&mut cfg, &one("color nosuchslot red default")).is_err());
1155    }
1156
1157    #[test]
1158    fn bind_macro_and_push_parse_but_stay_for_the_caller() {
1159        assert_eq!(
1160            one("bind index \\Cd delete-message"),
1161            Command::Bind {
1162                menu: Menu::Index,
1163                key: "\\Cd".into(),
1164                function: "delete-message".into()
1165            }
1166        );
1167        assert_eq!(parse("bind index,pager d delete-message").unwrap().len(), 2);
1168        assert!(parse("bind nosuchmenu d delete").is_err());
1169        assert_eq!(
1170            one("macro index L \"l~f jane<enter>\""),
1171            Command::Macro {
1172                menu: Menu::Index,
1173                key: "L".into(),
1174                seq: "l~f jane<enter>".into()
1175            }
1176        );
1177        assert_eq!(one("push \"<enter>\""), Command::Push("<enter>".into()));
1178        assert_eq!(one("exec sync"), Command::Exec("sync".into()));
1179        assert_eq!(
1180            one("alias jane Jane Doe <jane@x>"),
1181            Command::Alias {
1182                nick: "jane".into(),
1183                expansion: "Jane Doe <jane@x>".into()
1184            }
1185        );
1186        // The config half leaves them alone.
1187        let mut cfg = Config::default();
1188        assert_eq!(apply(&mut cfg, &one("exec sync")).unwrap(), None);
1189    }
1190
1191    #[test]
1192    fn reset_restores_the_default_where_unset_zeroes() {
1193        let mut cfg = Config::default();
1194        for line in ["set pager_context=7", "set nobeep", "set editor=vim"] {
1195            apply(&mut cfg, &one(line)).unwrap();
1196        }
1197        assert_eq!(cfg.pager.context, 7);
1198        for cmd in parse("reset pager_context beep editor").unwrap() {
1199            apply(&mut cfg, &cmd).unwrap();
1200        }
1201        let fresh = Config::default();
1202        assert_eq!(cfg.pager.context, fresh.pager.context);
1203        assert_eq!(cfg.ui.beep, fresh.ui.beep, "back on, not off");
1204        assert_eq!(cfg.mail.editor, fresh.mail.editor);
1205        assert!(apply(&mut cfg, &one("reset all")).is_err());
1206        assert!(parse("reset").is_err(), "reset wants a name");
1207    }
1208
1209    #[test]
1210    fn uncolor_takes_rules_and_slots_back_out() {
1211        let mut cfg = Config::default();
1212        for line in [
1213            "color index brightyellow default ~F",
1214            "color index red default ~f jane",
1215            "color index blue default ~s urgent",
1216            "color body green default ^Signed",
1217            "color status white blue",
1218            "color quoted1 cyan default",
1219        ] {
1220            apply(&mut cfg, &one(line)).unwrap();
1221        }
1222        assert_eq!(cfg.color_index.len(), 2, "~F went to the flagged slot");
1223        apply(&mut cfg, &one("uncolor index ~f jane")).unwrap();
1224        assert_eq!(cfg.color_index.len(), 1);
1225        assert_eq!(cfg.color_index[0].pattern, "~s urgent");
1226        apply(&mut cfg, &one("uncolor index ~F")).unwrap();
1227        assert!(!cfg.colors.contains_key("flagged"));
1228        apply(&mut cfg, &one("uncolor index *")).unwrap();
1229        assert!(cfg.color_index.is_empty());
1230        apply(&mut cfg, &one("unmono body ^Signed")).unwrap();
1231        assert!(cfg.color_body.is_empty());
1232        apply(&mut cfg, &one("uncolor status")).unwrap();
1233        assert!(!cfg.colors.contains_key("status_fg"));
1234        apply(&mut cfg, &one("uncolor quoted1")).unwrap();
1235        assert!(!cfg.colors.contains_key("quoted1"));
1236        assert!(
1237            apply(&mut cfg, &one("uncolor index")).is_err(),
1238            "a pattern or *"
1239        );
1240    }
1241
1242    #[test]
1243    fn mono_is_a_color_line_carrying_an_attribute() {
1244        let mut cfg = Config::default();
1245        apply(&mut cfg, &one("mono index bold ~N")).unwrap();
1246        assert_eq!(cfg.color_index[0].fg.as_deref(), Some("bold"));
1247        assert_eq!(cfg.color_index[0].bg, None);
1248        assert!(parse("mono index shiny ~N").is_err(), "no such attribute");
1249    }
1250
1251    #[test]
1252    fn unhook_and_unmailboxes_clear_by_name_or_star() {
1253        let mut cfg = Config::default();
1254        cfg.folder_hooks.push(Default::default());
1255        cfg.message_hooks.push(Default::default());
1256        cfg.mail.mailboxes = vec!["~/Mail/a".into(), "~/Mail/b/".into(), "imap:w/INBOX".into()];
1257        apply(&mut cfg, &one("unhook folder-hook")).unwrap();
1258        assert!(cfg.folder_hooks.is_empty() && !cfg.message_hooks.is_empty());
1259        assert!(
1260            apply(&mut cfg, &one("unhook send-hook")).is_err(),
1261            "not a type rmut has"
1262        );
1263        apply(&mut cfg, &one("unhook *")).unwrap();
1264        assert!(cfg.message_hooks.is_empty());
1265        apply(&mut cfg, &one("unmailboxes ~/Mail/b")).unwrap();
1266        assert_eq!(
1267            cfg.mail.mailboxes,
1268            ["~/Mail/a", "imap:w/INBOX"],
1269            "a slash is no difference"
1270        );
1271        apply(&mut cfg, &one("unmailboxes *")).unwrap();
1272        assert!(cfg.mail.mailboxes.is_empty());
1273    }
1274}