the Zen of Python.png
第一章
1.1 Python版本
- 2.x版本
2.5以及更老的版本 目前实际上已经废弃，不需再去支持它们。
2.6版本 只有在旧版本操作系统如：Red Hat企业版Linux上发现。
2.7版本 是2.x的最后一个版本，仍然是使用较多的版本，Python 2.7将被继续支持到2020年，所以它很可能不会很快消失。 - 3.x版本
3.0、3.1和3.2版本发布之后都被快速地更替，并没有被广泛采用。
3.4和3.5版本是Python 3 最近发行的两个版本，也是应该重点支持的版本。Python 3.5 代表这门语言的未来，所以除非正专注于兼容老版本，否则都应该先确保代码能够运行在这两个最新版本上。
小结：Python 2.7 和 Python 3.4/3.5是我们主要关注和学习的版本，除非必须支持2.7版本，尽可能的学习新版本的Python，对于2.x和3.x的语言差异，不应该是学习这么语言的犹豫的地方，Just do it !
1.2 项目布局
项目结构应该保持简单，审慎使用包和层次结构，过深的层次结构在目录导航时将如同梦靥，但过平的层次结构会让项目变得臃肿。
常犯的错误：是将单元测试放在包目录的外面，这些测试实际上应该被包含在软件的子包中，以使：
- 不会偶尔被setuptools（或者其他打包库）作为tests顶层模块自动安装；
- 能够被安装，且被其他包用于构建自己的单元测试。
此外，应该避免创建那种只有一个init.py 文件的目录，例如，如果hooks.py够用的话就不要创建hooks/init.py，如果创建目录，那么其中就应该包含属于这个分类/模块的Python文件。
1.3 版本编号
Python生态系统正在对包的元数据进行标准化，其中一项元数据就是版本号。
N[.N] + [{a|b|c|rc}N][.postN][.devN]
如：1.2等于1.2.0 1.2.3等于1.2.3.0。
与N[.N]+相匹配的版本被认为是 最终版本。
基于日期的版本被认为是无效的，如2013.08.23
最终即将发布的组件也可以使用下面这种格式。
N[.N]+aN alpha版本
N[.N]+bN beta版本
N[.N]+cN或N[.N]+rcN(如0.4rc1) 候选版本
通常用到的还有以下这些后缀。
.postN (如1.4.post2)表示一个后续版本。 文档有误，细节调整使用，bug修复不应该使用，应该增加一个小的版本号。
.devN(如2.3.1.dev3)表示一个开发版本，表示一个质量基本合格的发布前的版本，例如2.3.1.dev3表示2.3.1 版本的第三个开发版本，它早于任何的alpha版本、beta版本，候选版本和最终版本。
1.4 编码风格与自动检查
Python 具有其他语言少有的绝佳质量，使用缩进来定义代码块。
Python代码主要规范：
- 每个缩进层级使用4个空格。
- 每行最多79个字符。
- 顶层的函数或类的定义之间空两行。
- 采用ASCII或UTF-8编码文件。
- 在文件顶端，注释和文档说明之下，每行每条 import 语句只导入一个模块同时要安标准库、第三方库和本地库的倒入顺序进行分组。
- 在小括号、中括号、大括号之间或者逗号之前没有额外的空格。
- 类的命名采用骆驼命名法，如 CamelCase；异常的定义使用Error 前缀（如适用的话）；函数的命令使用下划线分隔的小写字母，如 separated_by_underscores；用下划线开头定义私有的属性或方法，如_private。
这些规范很容易遵守，而且实际上很合理，大部分程序员在按照这些规范进行代码编写时，并没有什么不便。
工具pep8(https://pypi.python.org/pypi/pep8)能够自动检查Python 文件是否符合PEP 8要求。
$ pep8 hello.py
Hello.py:4:1: E302 expected 2 blank lines ,found 1
$ echo $?
1
OpenStack 项目
也可以使用--ignore选择忽略某些特定的错误或警告，如：
$ pep8--ignore=E3 hello.py
$ echo $?
0
