pep8 --first test.py
长字符串换
print 'You\'d need to know \'bout escapes with' \
'\\ that do \n newlines and \t tabs.'
或
print ('You\'d need to know \'bout escapes with'
'\\ that do \n newlines and \t tabs.') :?:
print语句下面应该有个空行(new line)
pep8 --show-source --show-pep8 test.py
推荐使用空格来进行缩进。
Tab应该只在现有代码已经使用tab进行缩进的情况下使用，以便和现有代码保持一致。
Python 3不允许tab和空格混合使用。
Python 2的代码若有tab和空格混合使用的情况，应该把tab全部转换为只有空格。
当使用命令行运行Python 2时，使用-t选项，会出现非法混用tab和空格的警告。当使用-tt选项时，这些警告会变成错误。强烈推荐使用这些选项！
每行最大长度(Maximum Line Length)
将所有行都限制在79个字符长度以内。
有时续行只能使用反斜杠才。例如，较长的多个with语句不能采用隐式续行，只能接受反斜杠表示换行：
with open('/path/to/some/file/you/want/to/read') as file_1, \
open('/path/to/some/file/being/written', 'w') as file_2:
file_2.write(file_1.read())
空行(Blank Line)
使用2个空行来分隔最高级的函数(function)和类(class)定义。
使用1个空行来分隔类中的方法(method)定义。
Imports
Imports应该分行写，而不是都写在一行，例如：
# 分开写
import os
import sys
# 不要像下面一样写在一行
import sys, os
这样写也是可以的：
from subprocess import Popen, PIPE
Imports应该写在代码文件的开头，位于模块(module)注释和文档字符串之后，模块全局变量(globals)和常量(constants)声明之前。
Imports应该按照下面的顺序分组来写：
标准库imports
相关第三方imports
本地应用/库的特定imports
不同组的imports之前用空格隔开。
Python有一种独一无二的的注释方式: 使用文档字符串.
文档字符串是包, 模块, 类或函数里的第一个语句.
这些字符串可以通过对象的__doc__成员被自动提取, 并且被pydoc所用.
(你可以在你的模块上运行pydoc试一把, 看看它长什么样).
我们对文档字符串的惯例是使用三重双引号”“”( PEP-257 ).
一个文档字符串应该这样组织: 首先是一行以句号, 问号或惊叹号结尾的概述(或者该文档字符串单纯只有一行).
接着是一个空行. 接着是文档字符串剩下的部分, 它应该与文档字符串的第一行的第一个引号对齐.
下面有更多文档字符串的格式化规范.
def fetch_bigtable_rows(big_table, keys, other_silly_variable=None):
"""Fetches rows from a Bigtable.
Retrieves rows pertaining to the given keys from the Table instance
represented by big_table. Silly things may happen if
other_silly_variable is not None.
Args:
big_table: An open Bigtable Table instance.
keys: A sequence of strings representing the key of each table row
to fetch.
other_silly_variable: Another optional variable, that has a much
longer name than the other args, and which does nothing.
Returns:
A dict mapping keys to the corresponding table row data
fetched. Each row is represented as a tuple of strings. For
example:
{'Serak': ('Rigel VII', 'Preparer'),
'Zim': ('Irk', 'Invader'),
'Lrrr': ('Omicron Persei 8', 'Emperor')}
If a key from the keys argument is missing from the dictionary,
then that row was not found in the table.
Raises:
IOError: An error occurred accessing the bigtable.Table object.
"""
pass
代码规范：
http://nanshu.wang/post/2015-07-04/
https://www.douban.com/note/134971609/
https://lizhe2004.gitbooks.io/code-style-guideline-cn/content/python/python-pep8.html
http://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python_style_rules/#comments
将notepad++ python语言默认的tab改成4个空格的方法：
设置->首选项->制表符设置->python->取消‘使用默认值’
其它代码规范标准和工具：
Google python style guide
Pylint,Pyflakes,Pychecker 等
三元操作符
x=0
y=-2
print x if x<y else y
输出-2
python不支持switch case
可以用if..elif..else 代替
或者用
def f(x):
return {
0:"first",
1:"second",
2:"third",
3:"four"
}.get(x, "error input")
定义常量,参考：http://www.malike.net.cn/blog/2013/11/03/python-constants/
class _const:
class ConstError(TypeError):
pass
class ConstCaseError(ConstError):
pass
def __setattr__(self, name, value):
if (self.__dict__.has_key(name)):
raise self.ConstError, "Can't change const.%s" % name
if not name.isupper():
raise self.ConstCaseError, \
'const name "%s" is not all uppercase' % name
self.__dict__[name] = value
def __delattr__(self, name):
self.__dict__.has_key(name):
raise self.ConstError, "Can't unbind const const instance attribute (%s)" % name
raise AttributeError, "const instance has no attribute '%s'" % name
import sys sys.modules[__name__] = _const()
使用const
import const const.COMPANY = "NMG"