How to define CLI with subcommands and global arguments or flags using derive?

[mainrs]

I want a CLI that has a shared verbose flag for all subcommands. How can I define that using the derive API?

[pacak]

I'd have a top level Options struct containing all the shared flags as well as enum with commands:

#[derive(Debug, Clone, Bpaf)]
#[bpaf(options)]
struct Options {
    verbose: bool,
    #[bpaf(external)]
    action: Action
}

#[derive(Debug, Clone, Bpaf)]
enum Action {
    #[bpaf(command)]
    Foo,
    #[bpaf(command)]
    Bar,
}

[pacak]

You want to tell users what commands are available in --help like git --help prints everything even when not inside a git repo.

[mainrs]

The problem that I have is that the folder names can be arbitrary. It is out of my control.

[pacak]

So for every possible folder name you want to have a separate command? In that case one way would be

1. fallback_command example I gave above
2. mentioning the fact that there are magical command names in doc comments for top level options
3. if options taken by inner commands are similar you can define a parser for that and call with OptionParser::run_inner, you can construct Args from Vec<OsString> you get.

[mainrs]

Thank you very much!!!

[pacak]

You should be able to hide call to the inner parser into parse parameter on args field so the end consumer will get a parsed set of parameters.