Relax __all__ location.
Put all module level dunders together in the same location, and remove the redundant version bookkeeping information. Closes #27187. Patch by Ian Lee.
This commit is contained in:
parent
02a9d6de10
commit
0aa70aebf1
23
pep-0008.txt
23
pep-0008.txt
|
@ -365,8 +365,6 @@ Imports
|
|||
|
||||
You should put a blank line between each group of imports.
|
||||
|
||||
Put any relevant ``__all__`` specification after the imports.
|
||||
|
||||
- Absolute imports are recommended, as they are usually more readable
|
||||
and tend to be better behaved (or at least give better error
|
||||
messages) if the import system is incorrectly configured (such as
|
||||
|
@ -415,6 +413,14 @@ Imports
|
|||
public and internal interfaces still apply.
|
||||
|
||||
|
||||
Dunder Variables
|
||||
----------------
|
||||
|
||||
All relevant dunder variables (e.g. ``__all__``, ``__author__``,
|
||||
``__version__``, etc) should be placed after the module docstring and
|
||||
before any imports, separated by a blank line above and below.
|
||||
|
||||
|
||||
String Quotes
|
||||
=============
|
||||
|
||||
|
@ -689,19 +695,6 @@ Conventions for writing good documentation strings
|
|||
the same line.
|
||||
|
||||
|
||||
Version Bookkeeping
|
||||
===================
|
||||
|
||||
If you have to have Subversion, CVS, or RCS crud in your source file,
|
||||
do it as follows. ::
|
||||
|
||||
__version__ = "$Revision$"
|
||||
# $Source$
|
||||
|
||||
These lines should be included after the module's docstring, before
|
||||
any other code, separated by a blank line above and below.
|
||||
|
||||
|
||||
Naming Conventions
|
||||
==================
|
||||
|
||||
|
|
Loading…
Reference in New Issue