no default help command? about docopt HOT 9 CLOSED

From docs:

Note when docopt is set to automatically handle -h, --help and --version options, you still need to mention them in doc. Also for your users to know about them.

Anyway, thanks for you thorough feedback with several issues, this probably shows that the documentation is not clear enough. What do you think of docopt overall?

from docopt.

could work, still messing around

sub-commands need some more stuff to get more convenient wrt describing and referring to them

its impossible to scale up to larger tools, but seems fine for scripts and medium sized things

from docopt.

actually docopt was done to scale, take a look at git_example.py:

https://github.com/halst/docopt/blob/master/examples/git_example.py

API ideas welcome.

from docopt.

that’s only medium sized, by large i mean something like the complete interface of something like git/hg
including the possibility to extend it with new commands

i'd avoid to go that way for utterly insane complexity as reason

from docopt.

Actually docopt is going that way :-) but it will remain as simple as it is. One idea is to have a decorator @command so that you could specify usage patterns in docstrings for each of you internal functions. One that matches invocation will be executed. What do you think of that?

from docopt.

sounds interesting, currently i don't have a big enough use-case to try and see if its any good

from docopt.

but in a few months i'll write a cli for a scm abstraction tool, then i might have a use case

from docopt.

Let me know! I have not build any complex CLI (as git/hg), so I simply don't know what awaits someone when using docopt.

from docopt.

Updated docs: 77dc0ca

from docopt.