powerliners 0.2.12

1:1 Rust port of powerline/powerline. The ultimate statusline/prompt utility
Documentation 
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

// vim:fileencoding=utf-8:noet
//! Port of `powerline/commands/daemon.py`.
//!
//! Argument-spec for the `powerline-daemon` binary.

// from __future__ import (division, absolute_import, print_function)  // py:2
// import argparse                                  // py:4

use crate::ported::commands::lint::{ArgAction, ArgParser, Argument};

/// Port of `get_argparser()` from `powerline/commands/daemon.py:7`.
///
/// Returns the argument parser for `powerline-daemon`.
pub fn get_argparser() -> ArgParser {
    // py:7
    ArgParser {
        description: "Daemon that improves powerline performance.".to_string(), // py:8
        arguments: vec![
            // py:9-17  --quiet / -q
            Argument {
                flags: vec!["--quiet".into(), "-q".into()],
                action: ArgAction::StoreTrue,
                metavar: None,
                help: "Without other options: do not complain about already running \
                       powerline-daemon instance. \
                       Will still exit with 1. \
                       With `--kill' and `--replace': do not show any messages. \
                       With `--foreground': ignored. \
                       Does not silence exceptions in any case."
                    .to_string(),
            },
            // py:18  --socket / -s
            Argument {
                flags: vec!["--socket".into(), "-s".into()],
                action: ArgAction::Store,
                metavar: None,
                help: "Specify socket which will be used for connecting to daemon.".to_string(),
            },
            // py:19  --kill / -k
            Argument {
                flags: vec!["--kill".into(), "-k".into()],
                action: ArgAction::StoreTrue,
                metavar: None,
                help: "Kill an already running instance.".to_string(),
            },
            // py:20  --foreground / -f
            Argument {
                flags: vec!["--foreground".into(), "-f".into()],
                action: ArgAction::StoreTrue,
                metavar: None,
                // Note: the upstream help text uses a typographic apostrophe
                // (U+2019) inside "don\u{2019}t" — preserved verbatim.
                help: "Run in the foreground (don\u{2019}t daemonize).".to_string(),
            },
            // py:21  --replace / -r
            Argument {
                flags: vec!["--replace".into(), "-r".into()],
                action: ArgAction::StoreTrue,
                metavar: None,
                help: "Replace an already running instance.".to_string(),
            },
        ],
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn daemon_parser_description_matches_upstream() {
        let p = get_argparser();
        assert_eq!(p.description, "Daemon that improves powerline performance.");
    }

    #[test]
    fn daemon_parser_has_five_arguments() {
        let p = get_argparser();
        assert_eq!(p.arguments.len(), 5);
    }

    #[test]
    fn daemon_parser_flag_set() {
        let p = get_argparser();
        let names: Vec<&str> = p
            .arguments
            .iter()
            .flat_map(|a| a.flags.iter().map(|s| s.as_str()))
            .collect();
        assert!(names.contains(&"--quiet"));
        assert!(names.contains(&"--socket"));
        assert!(names.contains(&"--kill"));
        assert!(names.contains(&"--foreground"));
        assert!(names.contains(&"--replace"));
    }
}