cmder 0.6.1

A simple, lightweight, command line argument parser for rust codebases
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
97
98
99
100
101
102
103
104

#![allow(unused)]

use cmder::{
    construct_theme, Color, Event, ParserMatches, Pattern, PredefinedThemes, Theme,
    {Program, Setting},
};
/// This is an example of a program that uses commands which have subcommands themselves. The example used here emulates the docker cli. i.e
/// docker container ls, docker image ls, docker image build
fn main() {
    let mut program = Program::new();

    program
        .bin_name("docker")
        .author("vndaba")
        .description("An example of a program with subcommands");

    // Bind the newly created subcmd to a variable
    let mut img_cmd = program.subcommand("image");

    img_cmd
        .description("A command housing all the subcommands for image functionality")
        .alias("i");

    // You can then chain the subcommand method to add subcmds to the subcmd.
    img_cmd
        .subcommand("ls")
        .alias("l")
        .option("-l --long", "Use the long listing method")
        .description("List all the docker images available")
        .action(cmd::img_ls_cb);

    img_cmd
        .subcommand("build")
        .argument("<path>", "The path to the build context")
        .alias("b")
        .option("-q --quiet", "Supress output when building")
        .description("Build a docker image from provided context")
        .action(cmd::img_build_cb);

    img_cmd
        .subcommand("prune")
        .argument("<image-name>", "The name of the image to prune")
        .alias("p")
        .option("-a --all", "Remove all unused images")
        .description("Remove the provided image or all unused images")
        .action(cmd::img_prune_cb);

    // The docker container example command
    let mut cont_cmd = program.subcommand("container");

    cont_cmd
        .alias("cont")
        .description("A command housing all subcommands for containers");

    cont_cmd
        .subcommand("ls")
        .alias("l")
        .option("-l --long", "Use the long listing method")
        .option("-a --all", "List even stopped conatiners")
        .description("List all the docker containers available")
        .action(cmd::cont_ls_cb);

    cont_cmd
        .subcommand("start")
        .alias("s")
        .option(
            "-p --port <port-number>",
            "Add port mappings from container to host",
        )
        .option("-i --interactive", "Start container in interactive shell")
        .option("-d --detached", "Start container in detached state")
        .action(cmd::cont_start_cb);

    program.parse();
}

mod cmd {
    use cmder::ParserMatches;

    pub fn img_build_cb(_m: ParserMatches) {
        // Command logic goes here
        println!("Image build command called");
    }

    pub fn img_prune_cb(_m: ParserMatches) {
        // Command logic goes here
        println!("Image prune command called");
    }

    pub fn img_ls_cb(_m: ParserMatches) {
        // Command logic goes here
        println!("Image list command called");
    }

    pub fn cont_start_cb(_m: ParserMatches) {
        // Command logic goes here
        println!("Container start command called");
    }

    pub fn cont_ls_cb(_m: ParserMatches) {
        // Command logic goes here
        println!("Container list command called");
    }
}