我应该如何在 python 注释中格式化长 url 并且仍然符合 PEP8

新手上路,请多包涵

在块评论中,我想引用一个长度超过 80 个字符的 URL。

显示此 URL 的首选约定是什么?

我知道 bit.ly 是一个选项,但 URL 本身是描述性的。缩短它然后嵌套评论描述缩短的 URL 似乎是一个蹩脚的解决方案。

原文由 Zach 发布,翻译遵循 CC BY-SA 4.0 许可协议

阅读 903
2 个回答

不要破坏网址:

 # A Foolish Consistency is the Hobgoblin of Little Minds [1]
# [1]: http://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds

原文由 jfs 发布,翻译遵循 CC BY-SA 3.0 许可协议

来自 PEP8

但最重要的是:知道什么时候不一致——有时风格指南并不适用。如有疑问,请使用您的最佳判断。查看其他示例并确定最好的示例。不要犹豫,问!

打破特定规则的两个充分理由:

  • 应用规则会使代码的可读性降低,即使对于习惯阅读遵循规则的代码的人也是如此。

就个人而言,我会采纳该建议,而宁愿在您的评论中留下完整的描述性 URL 供人们使用。

原文由 Christian Witts 发布,翻译遵循 CC BY-SA 4.0 许可协议

撰写回答
你尚未登录,登录后可以
  • 和开发者交流问题的细节
  • 关注并接收问题和回答的更新提醒
  • 参与内容的编辑和改进,让解决方法与时俱进
推荐问题