Python中的命令行参数解析工具之docopt详解

前言

docopt 是一个开源的库，代码地址：https://github.com/docopt/docopt。它在 README 中就已经做了详细的介绍，并且还附带了很多例子可供学习，这篇文章也是翻译一下 README 中内容……

docopt 最大的特点在于不用考虑如何解析命令行参数，而是当你把心中想要的格式按照一定的规则写出来后，解析也就完成了。

docopt的安装

docopt有很多种版本，分别支持不同的语言，最简答的docopt支持python脚本，docopt.java支持java脚本，docopts则是支持shell脚本的（下面的例子主要以docopts为例），具体的可以参见github的docopt说明

安装docopt

以mac os x为例安装，安装docopts前首先需要安装docopt，有两种安装方法

方法一

比较简单的方法是直接用 pip 安装， pip install docopt==0.6.2

有些mac可能不支持直接pip 指令，需要先安装pip

方法二

也可以在github上下载源码（docopt是开源项目）,然后通过python setup.py install 安装

安装docopts

安装docopts就必须使用上面安装docopt的方法二，在GitHub上下载源码，然后 使用python安装，下载地址

docopt 的实现简单分析

在 Python 中有这么一个属性 __doc__ ，它的值是字符串，一般表示帮助信息，而 docopt 正是利用了这一属性，把帮助信息替换成命令行参数解析说明，再对它进行解析即可。

举个 docopt 中的例子来说明：

"""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 --versionOptions: -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 docoptif __name__ == '__main__': arguments = docopt(__doc__, version='Naval Fate 2.0') print(arguments)

上述代码段中，很大一段帮助信息就是我们的命令行参数解析说明，在函数入口处调用docopt函数进行解析，返回的arguments变量是一个字典型变量，它记录了选项是否被选用了，参数的值是什么等信息，当程序从命令行运行时，我们就是根据arguments变量的记录来得知用户输入的选项和参数信息。

所以如何写好命令行参数解析说明就变得至关重要了，命令行解析信息包含两部分，分别是使用模式格式和选项描述格式。

使用模式格式（Usage pattern format）

使用模式以usage:开始，以空行结束，如上代码段所示，它主要描述了用户添加命令行参数时的格式，也就是使用时的格式，解析也是按照此格式来进行的。