List required arguments after options about gist

[rtfmoz2]

Can you provide an example?

[nealmcb]

Sorry, I guess I meant gist create:

$ gist create /tmp/my_pastebin_file
Waiting for Emacs...

[nealmcb]

So the usage might be clearer to me as:
gist create [--public] [--encrypt] <desc> [FILES ...]

[jdowner]

I think this is something that could be easily supported if gist was using argparse. However it is currently using docopt which affords less flexibility in parsing the arguments. I have created a ticket to switch from docopt to argparse, which is something I would like to do anyway (see #89). Hopefully that change will resolve this issue as well.

@nealmcb One thing I do want to mention is that the original interface must continue to work. I'm happy if it can be flexible enough to support <desc> after the options, but I do not want to break the interface for other users.

[jdowner]

@nealmcb I've completed the transition from docopt to argparse. I think it provides the flexibility you're asking for. Can I ask you to download the latest version from master to make sure it works? If it does, I'll close this issue and push a new version to pypi.

[nealmcb]

Thanks again. I installed the latest (which is still labeled with version 0.9.2) and it works with the more natural syntax I like:

gist create --public "test gist command" README.rst 

but not with this usage, as still documented in the README:

gist create "test gist command desc first" --public README.rst

[jdowner]

@nealmcb Sorry to leave you hanging on this. I tried several different approaches to support this additional syntax but it became quite convoluted and brittle. So I have decided that I am not going to make this change and keep the current syntax.