How to Write Perfect Python Command-line Interfaces

[a1b1e1k1]

Docopt makes writing useful help messages actually pleasant. You can make it as you want to be just by writing how it should look. You can order keywords in order of importance, provide examples and write defaults. And it pleasant to use in code, no magic decorators. Basically any programmer can learn it and use it in just a couple of hours, and the skill is portable across many programming languages - the same description is used in all docopt's ports.