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

//! Command-line parser for `sq pki vouch list`.

use clap::Parser;

use crate::cli::types::CertDesignators;
use crate::cli::types::cert_designator;

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

const LIST_EXAMPLES: Actions = Actions {
    actions: &[
        Action::setup().command(&[
            "sq", "key", "import",
            "alice-secret.pgp",
        ]).build(),

        // Alice certifies that Bob controls
        // 511257EBBF077B7AEDAE5D093F68CB84CE537C9A and
        // bob@example.org.
        Action::setup().command(&[
            "sq", "pki", "vouch", "add",
            "--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0",
            "--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A",
            "--email=bob@example.org",
        ]).build(),

        Action::example().comment(
            "List certifications made by Alice.",
        ).command(&[
            "sq", "pki", "vouch", "list",
            "--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0"
        ]).build(),

        Action::example().comment(
            "List certifications made by Alice for Bob's certificate.",
        ).command(&[
            "sq", "pki", "vouch", "list",
            "--certifier=EB28F26E2739A4870ECC47726F0073F60FD0CBF0",
            "--cert=511257EBBF077B7AEDAE5D093F68CB84CE537C9A",
        ]).build(),
    ],
};
test_examples!(sq_pki_vouch_list, LIST_EXAMPLES);

#[derive(Parser, Debug)]
#[clap(
    name = "list",
    about = "List certifications",
    long_about = "\
List certifications

If the certifier argument is provided, then certifications made by the \
specified certificate are shown.  If the certificate argument is \
provided, then certifications of the specified certificate are shown. \
If both are provided, then certifications of the specified certificate \
made by the specified certifier are shown.

This command lists all of certifications, not just the active \
certification.

Because certifications are associated with the certificated \
certificate and not the certifier's certificate, this list is likely \
incomplete.

Stable since 1.2.0.
",
    after_help = LIST_EXAMPLES,
)]
pub struct Command {
    #[command(flatten)]
    pub certifier: CertDesignators<cert_designator::CertUserIDEmailFileSelfSpecialArgs,
                                   cert_designator::CertifierPrefix,
                                   cert_designator::OneOptionalValue>,

    #[command(flatten)]
    pub cert: CertDesignators<cert_designator::CertUserIDEmailFileArgs,
                              cert_designator::CertPrefix,
                              cert_designator::OneOptionalValue>,
}