sequoia-sq 1.4.0

Command-line frontends for Sequoia
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

//! Command-line parser for `sq config`.

use clap::Args;

use crate::cli::examples::*;

// XXX: We don't currently expose the set command.
#[derive(Debug, Args)]
#[clap(
    name = "set",
    about = "Set configuration options",
    long_about = "\
Set configuration options

Changes the configuration with the given key.  Use `sq config get` \
to see all existing options and their values.
",
    after_help = SET_EXAMPLES,
)]
// XXX: value and delete should be in an argument group, but doing
// that messes up the usage:
//
//   Usage: sq config set <VALUE|--delete> <NAME>
//
// Note how VALUE comes first.  I believe this is tracked upstream as
// https://github.com/clap-rs/clap/issues/1794
//
// For now, we do the validation in the command handler.
//
//#[clap(group(ArgGroup::new("action").args(&["value", "delete"]).required(true)))]
pub struct Command {
    #[clap(
        value_name = "NAME",
        help = "Set the value of the configuration NAME",
    )]
    pub name: String,

    #[clap(
        value_name = "VALUE",
        help = "New value for the configuration item",
    )]
    pub value: Option<String>,

    #[clap(
        long = "delete",
        help = "Delete the configuration item",
        conflicts_with = "value",
    )]
    pub delete: bool,

    #[clap(
        long = "add",
        help = "Add an item to a list of items",
        conflicts_with = "delete",
    )]
    pub add: bool,
}

const SET_EXAMPLES: Actions = Actions {
    actions: &[
        Action::Example(Example {
            comment: "\
Set the default cipher suite for key generation.",
            command: &[
                "sq", "config", "set", "key.generate.cipher-suite",
                "rsa3k",
            ],
            hide: &[],
        }),

        Action::Example(Example {
            comment: "\
Delete the default cipher suite for key generation.",
            command: &[
                "sq", "config", "set", "key.generate.cipher-suite",
                "--delete",
            ],
            hide: &[],
        }),

        Action::Example(Example {
            comment: "\
Add a default key server for network queries.",
            command: &[
                "sq", "config", "set", "network.keyservers",
                "--add", "hkps://keys.example.org",
            ],
            hide: &[],
        }),
    ]
};
// XXX: We don't currently expose the set command.
//test_examples!(sq_config_set, SET_EXAMPLES);