python - docopt 位置参数不起作用

Question

当遵循 docopt README 时，我希望以下文件产生一些有效的输出：

#!/usr/bin/env python
"""Example file.

Usage:

  test_docopt.py test
  test_docopt.py (-h | --help)
  test_docopt.py --version

Options:
  -h --help                       Show this screen
  --version                       Show version.

"""

import pkg_resources
pkg_resources.require("docopt==0.6.1")
from docopt import docopt

if __name__ == '__main__':
    args = docopt(__doc__, version="Extend limb profiles 0.1")
    print(args)

但是，当我打电话时test_docopt.py，我只会得到一个无意义/空的Usage语句：

$ python test_docopt.py test
Usage:

我的两个问题是：

• 为什么 docopt 显然无法识别test命令？
• 为什么使用模式没有填充实际的使用模式？

Answer 1

您需要删除Usage:与用法本身之间的空行。来自README.rst

使用模式是 doc 的一个子字符串，它以 usage: 开头（不区分大小写）并以明显的空行结尾。

Usage:在您结束使用模式后立即放置一个空行。