PyCodeStyle -崇高文本3-注释行长度

Question

我成功地设置了崇高文本3与SublimeLinter和PyCodeStyle一起工作。我喜欢用它来保持诚实，我已经为PyCodeStyle设置了PyCodeStyle配置文件，以忽略某些警告。这是我现在存在的文件。

{
"linters": {
"pycodestyle": {
  "ignore": ["E111", "E114"],
  "max-doc-length": 60,
},
// ... other linters' settings
}

我忽略了E111 & E114，因为在我的项目中，我必须使用缩进宽度为2，而且我不想因为没有使用4的倍数而一直被大喊大叫。

但是，我遇到困难的部分是第二个命令，当我的评论行太长时，我的目标是得到警告。我把它设置为60 (尽管PEP的72建议，我打算使用)，只是为了迫使它绊倒的林特。

无论我设置了什么，我都不会得到我期望得到的警告(W505: doc太长)。(我从来没有收到任何警告。)我也尝试过"-max-doc-length“和”-max-doc-length“，因为我知道后者是通过命令行完成时的选项。

有人知道我做错了什么吗?我怎么能说服林特每次我的评论都太长的时候给我一个严厉的教训？

会不会是版本问题？我注意到我可以在PyCodeStyle网页上看到上面引用的选项(搜索“-max-doc-length=n”)；但是，在我的系统上，当我键入pycodestyle --help时，我看不到这个选项。我看到了--max-line-length=n选项，但没有看到它下面的文档行。

pycodestyle --version的输出为2.4.0。

Answer 1

首先，是的，有一个版本问题。即使您有最新的版本(2.4.0，2018年4月10日发布)，max-doc-length还是添加了在该版本发布后，2018年5月11日。

我不知道为什么在没有2.4.0版本的情况下将其添加到docs中(可能是因为它们还没有将回购版的版本增加到2.4.1?)，但我不确定这是否值得报告。

无论如何，如果您想要这个特性(并且不想等待下一个版本)，您将不得不在GitHub之外安装最尖端的版本。

不过，我认为你无论如何都不想要这个功能。

max-doc-length (以及相应的W505警告)用于文档字符串，而不是注释。因此，它仍然不会发现你的评论行太长。

据我所知，pycodestyle没有任何方法为注释指定不同的长度；它们总是得到max-line-length。