为什么我的 docopt 选项没有默认值？

Question

我在我正在研究的模块的示例中使用docopt，所有选项默认值都在工作，除了一个。我已经修改了包含和围绕该选项的所有代码，试图识别问题，但它不会采用默认值!

我的选项块是这样的:

Options:
  --help                       Show this message and exit
  --version                    Show version info and exit
  -w WIDTH --width=WIDTH       The out to out width of the deck (feet) [default: 73]
  -g GIRDERS --girders=GIRDERS The number of girders [default: 8]
  -h HEIGHT --height=HEIGHT    The height of the girders (inches) [default: 56]
  -t THICK --thick=THICK       The deck thickness (inches) [default: 8]
  -a ADIM --adim=ADIM          The "A" dimension, max deck thick @ CL girder [default: 12]
  -l LSLP --leftslope=LSLP     The left-hand deck slope (ft/ft) [default: -0.02]
  -r RSLP --rightslope=RSLP    The right-hand deck slope (ft/ft) [default: -0.02]
  -c --center                  Indicates pivot point is at center of bridge
  -o OFFSET --offset=OFFSET    The offset of pivot point from center [default: 0]

girders选项没有默认值!

我把这个问题读了好几遍，但似乎都没有关系。

Answer 1

所以根据另一个问题中的建议，我克隆了docopt repo并安装了零效果的当前提示。现在我有了源代码，我决定做一些调试，看看是否能找到问题。

在Option类的parse方法的第200行是用于获取默认值的正则表达式:

matched = re.findall('[default: (.*)]', description, flags=re.I)

在打印了一堆周围的变量之后，我发现description vars的值是一个空字符串。下面这行设置了描述:

options, _, description = option_description.strip().partition(' ')

引起我注意的部分是:.partition(' ')，这是两个空格。因此，在成功更新代码后，我返回文档并搜索"空格":https://github.com/docopt/docopt#option-descriptions-format sixth bullet:

"用两个空格分隔选项及其非正式描述"

TL;DR RTFM(或至少代码)。

额外提示: docopt理解多行描述，所以您可以只换行超过80个字符的任何内容:

Options:
  --help                        Show this message and exit
  --version                     Show version info and exit
  -w WIDTH --width=WIDTH        The out to out width of the deck (feet) 
                                [default: 73]
  -g GIRDERS --girders=GIRDERS  The number of girders [default: 8]
  -h HEIGHT --height=HEIGHT     The height of the girders (inches) 
                                [default: 56]
  -t THICK --thick=THICK        The deck thickness (inches) [default: 8]
  -a ADIM --adim=ADIM           The "A" dimension, max. deck thickness at 
                                centerline of girder (inches) [default: 12]
  -l LSLP --leftslope=LSLP      The left-hand deck slope (ft/ft)
                                [default: -0.02]
  -r RSLP --rightslope=RSLP     The right-hand deck slope (ft/ft)
                                [default: -0.02]
  -c --center                   Indicates pivot point is at center of bridge
  -o OFFSET --offset=OFFSET     The offset of pivot point from center
                                [default: 0]

不太可读，但解析正确。