Python PEP 8 : Blank lines at the beginning of a module

Question

有一个question谁对待这个但不谈论我感兴趣的所有观点。

PEP 8 关于空行的说法:

Separate top-level function and class definitions with two blank lines.

那么如果你有:

1. 只有一个类的模块:

   # -*- coding: utf-8 -*-
   
   
   class A(object):
       pass
   

   你是否用两个空行分隔类的开头和编码注释？

2. 带有导入语句和类的模块:

   # -*- coding: utf-8 -*-
   
   import module
   
   
   class B(object):
       pass
   
   
   class C(object):
       pass
   

   导入语句和编码注释是否用一个空行分隔？

   导入语句和带有两个空行的类开头？

3. 还有一个主模块:

   #!/usr/bin/env python
   # -*- coding: utf-8 -*-
   
   import module
   
   
   def main():
       a = module.A()
       return 0
   
   
   if __name__ == '__main__':
       status = main()
   

   导入语句和顶层函数是否用两个空行分隔？

   顶层函数和条件语句的结尾有两个空行？

Answer 1

有一个名为 pep8 的 Python 模块它可以检查您的代码，看它是否符合 pep8 准则。

我尝试在您列出的示例和它们的几个变体上运行 pep8，一般来说，pep8 程序接受所有这些，因为它们符合 pep8 准则。所以基本上，您所有问题的答案都是是。

确实存在一定程度的主观性——例如，您可以在 main 函数和 if __name__ == '__main__' 段之间有两个或一个换行符。但是，我不会太担心 pep8 合规性——只需下载并安装 pep8 程序以及其他代码分析器(例如 pylint )。只要您的代码通过了这些测试，就足够了。