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:
Barry Warsaw 2016-06-07 16:25:19 -04:00
parent 02a9d6de10
commit 0aa70aebf1
1 changed files with 8 additions and 15 deletions

View File

@ -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
==================