mgt 0.2.4

Command line tool to analyze the WildFly management model.
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! Base clap command tree with subcommands and arguments.
//!
//! Defines the CLI structure (subcommands, flags, help text) without value
//! parsers or completion logic. [`main.rs`](crate) extends this via
//! `build_app_full()` to wire up parsers and tab-completion.

use clap::builder::Styles;
use clap::builder::styling::{AnsiColor, Effects};
use clap::{Arg, ArgAction, Command, crate_name, crate_version};

/// Builds the base clap `Command` tree with subcommands and arguments.
///
/// Does not attach value parsers or completion handlers — see
/// `build_app_full()` in `main.rs` for the fully wired version.
pub fn build_app() -> Command {
    Command::new(crate_name!())
        .version(crate_version!())
        .about("Command line tool to analyze the WildFly management model.")
        .styles(Styles::styled()
            .header(AnsiColor::Green.on_default() | Effects::BOLD)
            .usage(AnsiColor::Green.on_default() | Effects::BOLD)
            .literal(AnsiColor::Blue.on_default() | Effects::BOLD)
            .placeholder(AnsiColor::Cyan.on_default()))
        .propagate_version(true)
        .subcommand_required(true)
        .arg(Arg::new("json")
            .long("json")
            .global(true)
            .action(ArgAction::SetTrue)
            .help("Output results as JSON (for machine consumption)"))

        // analyze
        .subcommand(Command::new("analyze")
            .about("Analyze the management model of a WildFly instance or feature pack and build a self-contained Neo4J model image with the results")
            .arg(Arg::new("identifier")
                .required(true)
                .help("A WildFly version (e.g. 39, 26.1) or feature pack (e.g. ai, graphql)")))

        // push
        .subcommand(Command::new("push")
            .about("Push model images to the remote registry")
            .arg(Arg::new("identifier")
                .required(true)
                .help("WildFly versions, feature packs, or a mix (e.g. 34,ai,graphql)"))
            .arg(Arg::new("chunks")
                .short('c')
                .long("chunks")
                .value_name("SIZE")
                .help("Push in batches of SIZE images instead of all at once")))

        // start
        .subcommand(Command::new("start")
            .about("Start model containers")
            .arg(Arg::new("identifier")
                .required(true)
                .help("WildFly versions, feature packs, or a mix (e.g. 34,ai,graphql)")))

        // stop
        .subcommand(Command::new("stop")
            .about("Stop model containers")
            .arg(Arg::new("identifier")
                .required_unless_present("all")
                .help("WildFly versions, feature packs, or a mix (e.g. 34,ai,graphql)"))
            .arg(Arg::new("all")
                .short('a')
                .long("all")
                .action(ArgAction::SetTrue)
                .help("Stop all running Neo4J model DB containers")))

        // versions
        .subcommand(Command::new("versions")
            .about("List all supported WildFly versions"))

        // feature-packs
        .subcommand(Command::new("feature-packs")
            .about("List all supported feature packs"))

        // images
        .subcommand(Command::new("images")
            .about("List all available model images")
            .arg(Arg::new("wildfly")
                .short('w')
                .long("wildfly")
                .action(ArgAction::SetTrue)
                .help("Show only WildFly versions"))
            .arg(Arg::new("feature-packs")
                .short('f')
                .long("feature-packs")
                .action(ArgAction::SetTrue)
                .help("Show only feature packs")))

        // ps
        .subcommand(Command::new("ps")
            .about("List running model containers"))

        // browse
        .subcommand(Command::new("browse")
            .about("Open the Neo4J browser for running model containers")
            .arg(Arg::new("identifier")
                .required(true)
                .help("WildFly versions, feature packs, or a mix (e.g. 34,ai,graphql)")))

        // update
        .subcommand(Command::new("update")
            .about("Update WildFly and feature pack configuration files"))

        // completions
        .subcommand(Command::new("completions")
            .about("Generate and install shell completions")
            .arg(Arg::new("shell")
                .help("The shell to generate completions for [default: auto-detected]"))
            .arg(Arg::new("install")
                .short('i')
                .long("install")
                .action(ArgAction::SetTrue)
                .help("Install completions to the standard location for the shell")))
}