【问题标题】:Is docstring max line-length different to normal PEP8 standard?docstring max line-length 与普通 PEP8 标准不同吗?
【发布时间】:2012-04-25 23:51:55
【问题描述】:

所以我查看了一些代码并在 pylint 的帮助下将其提升到 PEP 8 标准,我注意到如果我在打印语句中使用三引号,其中文本超过 120 个字符(我们允许 120 而不是79) pylint 没有抱怨。
这是 pylint 中的一个错误 还是 它是否认为它可能是一个评论并且对行的长度更宽松 它不关心你走了多远引号中的字符串,因为您可能希望以这种方式格式化它们?

为了清楚起见:是的,pylint 在超过行长的所有其他情况下都能正常工作。

【问题讨论】:

    标签: python pylint docstring pep8 code-standards


    【解决方案1】:

    作为 pylint 维护者,我可以说这绝对是一个错误。

    @Jacxel : 如果您在 logilab.org 上注册时遇到问题,您仍然可以在 python-projects@logilab.org 邮件列表中发布 pb

    谢谢

    【讨论】:

      【解决方案2】:

      经常使用 pylint,我也注意到了这种不一致。在Maximum Line Length section of PEP8 中,它说:

      因此,请将所有行限制为最多 79 个字符。对于流动的长文本块(docstrings 或 cmets),建议将长度限制为 72 个字符。

      我知道 pylint 根本不强制 docstrings 和 cmets 的 79 个字符或 72 个字符的行长度限制,所以我猜这是一个 pylint 错误,因为它在该领域不符合 PEP8。

      【讨论】:

      • 由于存在提高宽度受限环境中可读性的建议,因此存在例外是没有意义的。
      • 所以这大概是一个错误,前几天我试图在执行 pylint 的网站上注册以向问题跟踪器添加一个项目,(对于我注意到的另一个错误)仍然没有收到不幸的是,一封激活电子邮件。
      猜你喜欢
      • 2021-02-02
      • 2015-02-21
      • 2019-05-08
      • 2017-04-30
      • 2012-05-21
      • 2014-06-20
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多