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
mod entrypoint;
mod help;
mod usage;
pub use self::{entrypoint::EntryPoint, help::Help, usage::Usage};
use crate::{runnable::Runnable, terminal};
use gumdrop::Options;
use std::fmt::Debug;
pub trait Command: Debug + Options + Runnable {
fn name() -> &'static str;
fn description() -> &'static str;
fn version() -> &'static str;
fn authors() -> &'static str;
fn from_args<A: IntoIterator<Item = String>>(into_args: A) -> Self {
let args: Vec<_> = into_args.into_iter().collect();
Self::parse_args_default(args.as_slice()).unwrap_or_else(|err| {
terminal::init();
Usage::for_command::<Self>().print_error_and_exit(err, args.as_slice());
})
}
fn from_env_args() -> Self {
let mut args = ::std::env::args();
assert!(args.next().is_some(), "expected one argument but got zero");
Self::from_args(args)
}
fn print_usage_and_exit(args: &[String]) -> ! {
Usage::for_command::<Self>().print_subcommand_and_exit(args);
}
fn subcommand_usage(_command: &str) -> Option<Usage> {
None
}
}
#[cfg(test)]
mod tests {
use crate::{Command, Options, Runnable};
#[derive(Command, Debug, Options)]
pub struct DummyCommand {}
impl Runnable for DummyCommand {
fn run(&self) {
panic!("unimplemented");
}
}
#[test]
fn derived_command_test() {
assert_eq!(DummyCommand::name(), "abscissa");
}
}