pep 8 规范的一些记录
一、pep8起源
龟叔创立Python的初衷里就有创立一个容易阅读的编程语言，所以亲自操刀写了pep8 代码规范，每个项目开始前都要有一个共识，就是自己的代码规范，pep8 就是一个很好的范本。
二、官网链接
https://www.python.org/dev/peps/pep-0008/
中文翻译链接
https://my.oschina.net/u/1433482/blog/464444
三、重要总结
一致性问题：
风格指南强调一致性。项目、模块或函数保持一致都很重要。
当遵循指南降低代码一致性，可读性的时候就不必强行修改。
代码布局：
缩进四个空格代替tab
行宽79个字符，文本长块72个字符
字符编码总是用UTF-8
导入模块：
导入时单行导入，开头导入，
顺序为标准库，本地库，第三方库，
尽量使用绝对路径，不用通配符导入，
空格：
括号内没有空格，
关键字参数和默认值参数的前后不要加空格
逗号，分号，冒号前无空格
运算符后有空格，
不推荐复合语句，一句一行
用英文写注释，及时更新注释，少用行内注释，文档字符串：为所有公共模块、函数、类和方法书写
命名：
最重要的原则
用户可见的API命名应遵循使用约定而不是实现。（不太明白）
命名风格
-
b(单个小写字母)
-
B(单个大写字母)
-
lowercase(小写串)
-
lower_case_with_underscores(带下划线的小写)
-
UPPERCASE(大写串)
-
UPPER_CASE_WITH_UNDERSCORES(带下划线的大写串)
-
CapitalizedWords(首字母大写的单词串或驼峰缩写）注意: 使用大写缩写时，缩写使用大写字母更好。故 HTTPServerError 比 HttpServerError 更好。
-
mixedCase(混合大小写，第一个单词是小写)
-
Capitalized_Words_With_Underscores（带下划线，首字母大写，丑陋）
首尾有下划线的情况:
-
_single_leading_underscore:(单前置下划线): 弱内部使用标志。 例如"from M import " 不会导入以下划线开头的对象。
-
single_trailing_underscore_(单后置下划线): 用于避免与 Python关键词的冲突。 例如：
Tkinter.Toplevel(master, class_='ClassName')
-
__double_leading_underscore(双前置下划线): 当用于命名类属性，会触发名字重整。 (在类FooBar中，__boo变成 _FooBar__boo)。
-
__double_leading_and_trailing_underscore__(双前后下划线)：用户名字空间的魔法对象或属性。例如:__init__ , __import__ or __file__，不要自己发明这样的名字。
命名约定规范
-
避免采用的名字
决不要用字符'l'(小写字母el)，'O'(大写字母oh)，或 'I'(大写字母eye) 作为单个字符的变量名。一些字体中，这些字符不能与数字1和0区别。用'L' 代替'l'时。
-
包和模块名
模块名要简短，全部用小写字母，可使用下划线以提高可读性。包名和模块名类似，但不推荐使用下划线。
模块名对应到文件名，有些文件系统不区分大小写且截短长名字，在 Unix上不是问题，但当把代码迁移到 Mac、Windows 或 DOS 上时，就可能是个问题。当然随着系统的演进，这个问题已经不是经常出现。
另外有些模块底层用C或C++ 书写，并有对应的高层Python模块，C/C++模块名有一个前置下划线 (如：_socket)。
-
类名
遵循CapWord。
接口需要文档化并且可以调用时，可能使用函数的命名规则。
注意大部分内置的名字是单个单词（或两个），CapWord只适用于异常名称和内置的常量。
-
异常名
如果确实是错误，需要在类名添加后缀 "Error"。
-
全局变量名
变量尽量只用于模块内部，约定类似函数。
对设计为通过 "from M import " 来使用的模块，应采用 __all__ 机制来防止导入全局变量；或者为全局变量加一个前置下划线。
-
函数名
函数名应该为小写，必要时可用下划线分隔单词以增加可读性。 mixedCase(混合大小写)仅被允许用于兼容性考虑(如: threading.py)。
-
函数和方法的参数
实例方法第一个参数是 'self'。
类方法第一个参数是 'cls'。
如果函数的参数名与保留关键字冲突，通常在参数名后加一个下划线。
-
方法名和实例变量
同函数命名规则。
非公开方法和实例变量增加一个前置下划线。
为避免与子类命名冲突，采用两个前置下划线来触发重整。类Foo属性名为__a， 不能以 Foo.__a访问。(执著的用户还是可以通过Foo._Foo__a。) 通常双前置下划线仅被用来避免与基类的属性发生命名冲突。
-
常量
常量通常在模块级定义,由大写字母用下划线分隔组成。比如括MAX_OVERFLOW和TOTAL。
-
继承设计
考虑类的方法和实例变量(统称为属性)是否公开。如果有疑问，选择不公开；把其改为公开比把公开属性改为非公开要容易。
公开属性可供所有人使用，并通常向后兼容。非公开属性不给第三方使用、可变甚至被移除。
这里不使用术语"private"， Python中没有属性是真正私有的。
另一类属性是子类API(在其他语言中通常称为 "protected")。 一些类被设计为基类，可以扩展和修改。
谨记这些Python指南：
-
公开属性应该没有前导下划线。
-
如果公开属性名和保留关键字冲突，可以添加后置下划线
-
简单的公开数据属性，最好只公开属性名，没有复杂的访问/修改方法，python的Property提供了很好的封装方法。 d.如果不希望子类使用的属性，考虑用两个前置下划线(没有后置下划线)命名。
公共和内部接口
任何向后兼容的保证只适用于公共接口。
文档化的接口通常是公共的，除非明说明是临时的或为内部接口、其他所有接口默认是内部的。
为了更好地支持内省，模块要在__all__属性列出公共API。
内部接口要有前置下划线。
如果命名空间(包、模块或类)是内部的，里面的接口也是内部的。
导入名称应视为实现细节。其他模块不能间接访名字，除非在模块的API文档中明确记载，如os.path中或包的__init__暴露了子模块。
