docopt位置参数不起作用

Question

当跟随docopt自述文件时，我希望下面的文件产生一些有效的输出：

#!/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时，我只得到一个无意义/空的用法语句：

$ python test_docopt.py test
Usage:

我的两个问题是：

• 为什么docopt显然无法识别测试命令？
• 为什么使用模式不包含实际的使用模式？

Answer 1

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

使用模式是doc的一个子字符串，它以使用：(大小写不敏感)开头，以一个明显的空行结束。

通过在Usage:之后放置一个空行，您就可以结束使用模式。