Re-introduce docopt? about rust-bindgen HOT 10 CLOSED

An alternative would be to use clap, which ia also very cool.

from rust-bindgen.

I like docopt because it forces us to at least minimally document our command line flags. That is a great property to have.

from rust-bindgen.

I too love docopt for that. Clap does the reverse: it generates the --help from the options.

from rust-bindgen.

I was under the impression that calling .help("...") on clap's builder was optional (meaning that the documentation is optional even if the help text contains all flags). Is that incorrect?

from rust-bindgen.

If you don't set it, clap auto-generates the --help.

from rust-bindgen.

I'm going to send a quick PR to fix some inaccuracies in the current --help, but I can see it needs more love. If you have a preference either way for docopt / clap, I'd be happy to plug one in.

from rust-bindgen.

The only thing I have against clap is that the matches are basically a Map<String, String>, while docopt auto-deserialize in a struct.

from rust-bindgen.

Looks like we'd be stuck with that style of interface either way for now, as docopt depends on a compiler plugin to deserialise into a struct, doesn't yet support custom derive, and I suspect Macros 1.1 might not land as soon as we'd hoped anyway.

I'll get started with docopt.

from rust-bindgen.

This can be resolved, as I reintroduced docopt… and then switched to clap in #228. 😂

from rust-bindgen.

Right, thanks!

from rust-bindgen.