supplement 0.2.3

The awesome supplement for your awesome CLI app
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

use crate::clap;

#[cfg(feature = "clap-3")]
pub type ClapCommand<'a> = &'a mut clap::Command<'static>;
#[cfg(feature = "clap-4")]
pub type ClapCommand<'a> = &'a mut clap::Command;

pub use clap::ArgAction;

#[cfg(feature = "clap-3")]
#[derive(Clone, Copy)]
pub(crate) struct Command<'a>(pub &'a clap::Command<'static>);
#[cfg(feature = "clap-4")]
#[derive(Clone, Copy)]
pub(crate) struct Command<'a>(pub &'a clap::Command);

#[cfg(feature = "clap-3")]
#[derive(Clone, Copy)]
pub(crate) struct Arg<'a>(&'a clap::Arg<'static>, bool);
#[cfg(feature = "clap-4")]
#[derive(Clone, Copy)]
pub(crate) struct Arg<'a>(&'a clap::Arg);

#[cfg(feature = "clap-3")]
pub type PossibleValue = clap::builder::PossibleValue<'static>;
#[cfg(feature = "clap-4")]
pub type PossibleValue = clap::builder::PossibleValue;

#[cfg(feature = "clap-3")]
pub type Id = str;
#[cfg(feature = "clap-4")]
pub type Id = clap::Id;

impl<'a> Command<'a> {
    pub fn get_arguments(&self) -> impl Iterator<Item = Arg<'a>> {
        #[cfg(feature = "clap-3")]
        {
            let positional_count = self.0.get_arguments().filter(|a| a.is_positional()).count();
            let mut cur = 0;
            self.0.get_arguments().map(move |a| {
                if a.is_positional() {
                    cur += 1;
                    let is_last_positional = cur == positional_count;
                    Arg(a, is_last_positional)
                } else {
                    Arg(a, false)
                }
            })
        }
        #[cfg(feature = "clap-4")]
        {
            self.0.get_arguments().map(Arg)
        }
    }
    pub fn get_subcommands(&self) -> impl Iterator<Item = Command<'a>> {
        self.0.get_subcommands().map(Command)
    }
    pub fn get_name(&self) -> &'a str {
        self.0.get_name()
    }
    pub fn get_about(&self) -> Option<String> {
        self.0.get_about().map(|s| s.to_string())
    }
    pub fn is_allow_external_subcommands_set(&self) -> bool {
        self.0.is_allow_external_subcommands_set()
    }
    pub fn is_disable_version_flag_set(&self) -> bool {
        self.0.is_disable_version_flag_set()
    }
    pub fn is_disable_help_flag_set(&self) -> bool {
        self.0.is_disable_help_flag_set()
    }
    pub fn is_disable_help_subcommand_set(&self) -> bool {
        self.0.is_disable_help_subcommand_set()
    }
}

impl<'a> Arg<'a> {
    pub fn is_positional(&self) -> bool {
        self.0.is_positional()
    }
    pub fn get_id(&self) -> &'a Id {
        self.0.get_id()
    }
    pub fn get_max_num_args(&self) -> usize {
        #[cfg(feature = "clap-3")]
        {
            if !self.takes_values() {
                return 0;
            }
            // "get_num_vals" is often None even if it should take a vector,
            // so we have to make some compromise:
            // If this is the last arg, make it infinite long, otherwise make it 1
            let default = if self.1 { std::usize::MAX } else { 1 };
            self.0.get_num_vals().unwrap_or(default)
        }
        #[cfg(feature = "clap-4")]
        {
            self.0.get_num_args().expect("built").max_values()
        }
    }
    pub fn get_min_num_args(&self) -> usize {
        #[cfg(feature = "clap-3")]
        {
            if !self.takes_values() { 0 } else { 1 }
        }
        #[cfg(feature = "clap-4")]
        {
            self.0.get_num_args().expect("built").min_values()
        }
    }
    pub fn is_require_equals_set(&self) -> bool {
        self.0.is_require_equals_set()
    }
    pub fn get_possible_values(&self) -> Vec<PossibleValue> {
        #[cfg(feature = "clap-3")]
        {
            if let Some(pvs) = self.0.get_possible_values() {
                return pvs.to_vec();
            }
        }
        self.0
            .get_value_parser()
            .possible_values()
            .map(|p| p.collect())
            .unwrap_or_default()
    }
    pub fn takes_values(&self) -> bool {
        #[cfg(feature = "clap-3")]
        {
            self.0.is_takes_value_set()
        }
        #[cfg(feature = "clap-4")]
        {
            self.0.get_num_args().expect("built").takes_values()
        }
    }
    pub fn is_global_set(&self) -> bool {
        self.0.is_global_set()
    }
    pub fn get_short_and_visible_aliases(&self) -> Option<Vec<char>> {
        self.0.get_short_and_visible_aliases()
    }
    pub fn get_long_and_visible_aliases(&self) -> Option<Vec<&'a str>> {
        self.0.get_long_and_visible_aliases()
    }
    pub fn get_action(&self) -> &ArgAction {
        self.0.get_action()
    }
    pub fn get_help(&self) -> String {
        self.0.get_help().unwrap_or_default().to_string()
    }
}