3 ms·
As someone who has never used either, the documentation and simple example of Click won hands down. I could use it for simple cases within 15 seconds of readin
by ramblerman 13y ago
As someone who has never used either, the documentation and simple example of Click won hands down.
I could use it for simple cases within 15 seconds of reading. Docopt not so much.
- aidos 13y agoYou're right - looking on the http://docopt.org/ http://docopt.org/ page it's not immediately obvious how it works. The general idea is that you don't specify any code, you just give the help message as text. Docopt parses that to figure out all the options etc and convert those into the parameters coming in to your system. It's a really clever idea. You specify the human interface, docopt converts that into the code version (so long as you adhere to a few common conventions). I haven't seen a cleaner system anywhere. From their example: """Naval Fate. Usage: naval_fate.py ship new <name>... naval_fate.py ship <name> move <x> <y> [--speed=<kn>] naval_fate.py ship shoot <x> <y> naval_fate.py mine (set|remove) <x> <y> [--moored | --drifting] naval_fate.py (-h | --help) naval_fate.py --version Options: -h --help Show this screen. --version Show version. --speed=<kn> Speed in knots [default: 10]. --moored Moored (anchored) mine. --drifting Drifting mine. """ from docopt import docopt if __name__ == '__main__': arguments = docopt(__doc__, version='Naval Fate 2.0') print(arguments)
- voltagex_ 13y agoThat's brilliant. I wonder if there's a way to use docstrings like that to create REST services in Flask.