制作基于pbr的python可发布package

标题可能描述的不太清楚，这里所谓的可发布package意思是一个python package中要包含自己的测试例和依赖，用户在安装时只需指定这个package进行安装就能够将所有依赖一起装上。

只讲依赖的事情。

使用setuptools实现这个需求非常简单，setup.py中关键字install_requires就用在此时，其参数是一个字符串的list，而且可以指定版本号，唯一的问题是所谓的“抽象依赖”，也就是无法指定package的来源。这种方式可以实现在安装当前package时自动处理依赖。

另一个方案就是requirements.txt，文件名作为pip -r的参数，能够指定package的来源和版本号。这种方式可以用来快速安装大量依赖、创建工作环境，但是不解决自动安装依赖的问题，经常在tox或pipeline中用到。

在开发测试过程中发现，使用了pbr后setup.py中的install_requires不工作了，所列举的依赖没有被安装。

通过阅读OpenStack文档，逐渐掉进了一个陷阱。

首先，pbr是什么，为什么要用它？

pbr是OpenStack用于统一构建setuptools配置的一个工具。它将配置从setup.py隔离出来放在setup.cfg中，然后通过钩子在调用时将参数传递给setup.py。pbr能够根据git自动生成版本号、提取Author信息和ChangeLog，处理依赖及其他一些功能。

在pbr处理依赖这部分就有点晕了，感觉文档两个地方讲的不一致，pbr的设计在依赖处理上有些反人类。