kbknapp / clap-rs / 1867
94%

DEFAULT BRANCH: master
Ran
Jobs 1
Files 43
Run time 2s
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
1867

Pull #465

travis-ci

kbknapp 
feat(Macros): adds a subcommands! macro for defining an enum to access subcommands

Instead of defining all trait implementations manually, one can now do
the following:

```
// Note lowercase variants, the subcommand will be exactly as typed here
subcommands!{
    enum MyProg {
        show,
        delete,
        do,
    }
}

// Alternatively, if you wish to have variants which display
// differently, or contain hyphens ("-") one can use this variation of
// the macro
subcommands!{
    enum MyProgAlt {
        Show => "show",
        Delete => "delete",
        DoStuff => "do-stuff",
    }
}

fn main() {
    let m = App::new("myprog")
        .subcommand(SubCommand::with_name(MyProg::show))
        .subcommand(SubCommand::with_name(MyProg::delete))
        .subcommand(SubCommand::with_name(MyProg::do))
        .get_matches();

    match m.subcommand() {
        (MyProg::show, _) => println!("'myprog show' was used"),
        (MyProg::delete, _) => println!("'myprog delete' was used"),
        (MyProg::do, _) => println!("'myprog do' was used"),
        (MyProg::None, _) => println!("No subcommand was used"),
    }
}
```

**NOTE:** It's good practice to make the name of the enum the same as
the parent command, and the variants the names of the actual subcommands

Notice a fourth "None" option was automatically added.

This allows rustc to do some checking for you, i.e. if you add another
subcommand later, but forget to check for it, rustc will complain about
NonExaustive matches. Likewise, if you make a simple spelling or typing
error.

Relates to #459
Pull Request #465: Issue 459 - Use enums in place of strings

3784 of 4267 relevant lines covered (88.68%)

0.89 hits per line

Uncovered Existing Lines

Lines Coverage ∆ File
1
86.82
 -0.4% src/args/arg.rs
2
80.56
 -2.3% src/macros.rs
2
87.88
 0.0% src/args/arg_matches.rs
Jobs
ID Job ID Ran Files Coverage
4 1867.4 43
88.68
 Travis Job 1867.4
Source Files on build 1867
Coverage ∆ File Lines Relevant Covered Missed Hits/Line