第一章

1.1 Python版本

1. 2.x版本

• 2.5以及更老的版本 目前实际上已经废弃，不需再去支持它们。
• 2.6版本 只有在旧版本操作系统如：Red Hat企业版Linux上发现。
• 2.7版本 是2.x的最后一个版本，仍然是使用较多的版本，Python 2.7将被继续支持到2020年，所以它很可能不会很快消失。

2.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 项目布局

项目结构应该保持简单，审慎使用包和层次结构，过深的层次结构在目录导航时将如同梦靥，但过平的层次结构会让项目变得臃肿。

常犯的错误

常犯的错误：是将单元测试放在包目录的外面，这些测试实际上应该被包含在软件的子包中，以使：

• 1. 不会偶尔被setuptools（或者其他打包库）作为tests顶层模块自动安装；
• 1. 能够被安装，且被其他包用于构建自己的单元测试。

小结

此外，应该避免创建那种只有一个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代码主要规范：

1. 每个缩进层级使用4个空格。
2. 每行最多79个字符。
3. 顶层的函数或类的定义之间空两行。
4. 采用ASCII或UTF-8编码文件。
5. 在文件顶端，注释和文档说明之下，每行每条 import 语句只导入一个模块同时要安标准库、第三方库和本地库的倒入顺序进行分组。
6. 在小括号、中括号、大括号之间或者逗号之前没有额外的空格。

7. 类的命名采用骆驼命名法，如 CamelCase；异常的定义使用Error 前缀（如适用的话）；函数的命令使用下划线分隔的小写字母，如 separated_by_underscores；用下划线开头定义私有的属性或方法，如_private。
   这些规范很容易遵守，而且实际上很合理，大部分程序员在按照这些规范进行代码编写时，并没有什么不便。
   工具 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