如何用docopt实现带两个参数的可重复--path选项？

嘿，这个需求完全可以实现！你想要的是让--path选项每次接收两个参数，还能重复调用这个选项对吧？docopt对这种场景支持得很好，只需要调整一下用法字符串的写法就行。

先说说你原有写法的局限 #

你之前的代码里，[--path ARG]...的定义是让--path每次只接受单个参数，然后通过...允许重复使用这个选项。这就是为什么它只支持./foo --path "old" --path "new"这种调用方式——每个--path只能带一个值。

正确的实现方式 #

要让--path每次接收两个参数，只需要在选项后面明确指定两个参数占位符，再保留...来支持重复调用即可。比如我们可以把参数命名为<source>和<dest>，让用法更清晰：

#!/usr/bin/env python3
'''foo
Usage: foo [--path <source> <dest>]...

Options:
  --path <source> <dest>  指定源路径和目标路径（可重复使用该选项）。
'''
import docopt

args = docopt.docopt(__doc__)
print(args)

测试调用场景 #

现在这个脚本就支持你想要的两种调用方式了：

1. 单次使用--path选项

$ ./foo --path "old" "new"

输出结果：

{'--path': [['old', 'new']]}

2. 重复使用--path选项

$ ./foo --path "old1" "new1" --path "old2" "new2"

输出结果：

{'--path': [['old1', 'new1'], ['old2', 'new2']]}

原理说明 #

docopt会把每个--path后面的两个参数打包成一个子列表，然后所有重复的--path对应的子列表会被统一收集到一个大列表里。后续你处理的时候，只需要遍历args['--path']就能拿到每一组路径对了。

如果不需要明确的语义命名，你也可以用更简洁的写法，比如[--path OLD NEW]...，效果是一样的——关键是要在选项后指定多个参数占位符，再配合...实现重复调用。

内容的提问来源于stack exchange，提问作者Tom de Geus