pep: python-enhanced-proposal



Python Enhancement Proposal.
PEP 提供了大量的语法糖。
PEP stands for Python Enhancement Proposal. A PEP is a design document providing information to the Python community, or describing a new feature for Python or its processes or environment.

PEP-8 Coding style

PEP8 标准已经被封装成一个工具
pip install pep8
pycodestyle ...
warnings.warn( E302 expected 2 blank lines, found 1 E301 expected 1 blank line, found 0
其他 Python 静态代码检测工具:pyflakes, pylint
一行代码长度:79 chars
# Wrong:
# operators sit far away from their operands
income = (gross_wages +
taxable_interest +
(dividends - qualified_dividends) -
ira_deduction -
# Correct:
# easy to match operators with operands
income = (gross_wages
+ taxable_interest
+ (dividends - qualified_dividends)
- ira_deduction
- student_loan_interest)
Imports should be grouped in the following order:
  1. 1.
    Standard library imports.
  2. 2.
    Related third party imports.
  3. 3.
    Local application/library specific imports.
You should put a blank line between each group of imports.
模块级 dunder names
Module level "dunders" (i.e. names with two leading and two trailing underscores) such as __all__, __author__, __version__, etc. should be placed after the module docstring but before any import statements except from __future__ imports. Python mandates that future-imports must appear in the module before any other code except docstrings:
"""This is the example module.
This module does stuff.
from __future__ import barry_as_FLUFL
__all__ = ['a', 'b', 'c']
__version__ = '0.1'
__author__ = 'Cardinal Biggles'
import os
import sys
whitespace 的使用惯例
# Correct:
foo = (0,)
# Wrong:
bar = (0, )
# Correct:
i = i + 1
submitted += 1
x = x*2 - 1
hypot2 = x*x + y*y
c = (a+b) * (a-b)
# Wrong:
submitted +=1
x = x * 2 - 1
hypot2 = x * x + y * y
c = (a + b) * (a - b)
# Correct:
def complex(real, imag=0.0):
return magic(r=real, i=imag)
# Wrong:
def complex(real, imag = 0.0):
return magic(r = real, i = imag)
# Correct:
'tox.ini', # 可能在后期进行扩展
# Wrong:
FILES = ['setup.cfg', 'tox.ini',]
initialize(FILES, error=True,)

PEP-343 The "with" Statement

Author: Guido van Rossum, Nick Coghlan
Created: 13-May-2005


with 用于异常发生时,及时释放异常涉及的资源
with statement in Python is used in exception handling to make the code cleaner and much more readable. It simplifies the management of common resources like file streams.
# file handling
# 1) without using with statement
file = open('file_path', 'w')
file.write('hello world !')
# 2) without using with statement
file = open('file_path', 'w')
file.write('hello world')
# using with statement
with open('file_path', 'w') as file:
file.write('hello world !')
Notice that unlike the first two implementations, there is no need to call file.close() when using with statement. The with statement itself ensures proper acquisition and release of resources. An exception during the file.write() call in the first implementation can prevent the file from closing properly which may introduce several bugs in the code, i.e. many changes in files do not go into effect until the file is properly closed.
The second approach in the above example takes care of all the exceptions but using the with statement makes the code compact and much more readable. Thus, with statement helps avoiding bugs and leaks by ensuring that a resource is properly released when the code using the resource is completely executed. The with statement is popularly used with file streams, as shown above and with Locks, sockets, subprocesses and telnets etc.

兼容 Python2.x

In Python 2.5, the new syntax will only be recognized if a future statement is present:
from __future__ import with_statement
This will make both 'with' and 'as' keywords. Without the future statement, using 'with' or 'as' as an identifier will cause a Warning to be issued to stderr.
In Python 2.6, the new syntax will always be recognized; 'with' and 'as' are always keywords.

Supporting the “with” statement in user defined objects

PEP-440 Software Version

PEP 440 introduces a version format that every Python package, and ideally everyapplication, should follow.


"Projects" are software components that are made available for integration. Projects include Python libraries, frameworks, scripts, plugins, applications, collections of data or other resources, and various combinations thereof. Public Python projects are typically registered on the Python Package Index.
"Releases" are uniquely identified snapshots of a project.
"Distributions" are the packaged files which are used to publish and distribute a release.