为什么我的 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 选项永远没有默认值！

我重读了几次this question，但似乎无关。

Answer 1

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

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第六个子弹：

“使用两个空格来分隔带有非正式描述的选项”

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]

可读性差，但解析正确。