OpenStack基础知识-tox的详解介绍

1、tox简介
tox是通用的虚拟环境管理和测试命令行工具。tox能够让我们在同一个Host上自定义出多套相互独立且隔离的python环境，每套虚拟环境中可能使用了不同的 Python 拦截器/环境变量设置/第三方依赖包。所以 tox 最典型的应用就是用于测试 Python 程序的兼容性了。tox是openstack社区最基本的测试工具，比如python程序的兼容性、UT等。
它的目标是提供最先进的自动化打包、测试和发布功能。
1）作为持续集成服务器的前端，大大减少测试工作所需时间；
2）检查软件包能否在不同的python版本或解释器下正常安装；
3）在不同的环境中运行测试代码。
一般 openstack 项目中的 tox 的功能包含了: 打源码包(sdist)、单元测试(UT)、测试覆盖率(coverage)、代码格式检查(pep8，flake) 等功能.
关键字解释：打源码包（sdist）、单元测试（UT）、测试覆盖率（coverage）、代码格式检查（pep8，flake）

2、使用pip方式安装tox
1)安装pip
安装epel扩展源：
yum -y install epel-release
更新完成之后，就可安装pip：
yum -y install python-pip
安装完成之后清除cache：
yum clean all

2)安装tox
$ pip install tox

备注：
安装过程中需要提前安装的一些依赖包
yum install python-devel
yum install libffi-devel
yum install openssl-devel
yum install gcc
yum install gcc-c++

3、tox的运行命令
tox -e pep8 #对代码进行检查
tox -e py27 #构建测试环境
当我们执行 tox -e py27 时就是开始项目的单元测试, tox 首先会读取项目根目录下的 tox.ini 文件，然后根据该文件来构建出相应的虚拟环境, 并将该虚拟环境保存在 .tox/ 目录下的相应文件中(以环境的名称来命名)
实例如下：
/opt/stack/keystone/.tox$ ls
log pep8 py27
除了 log 之外的 py27/pep8 都是 virtualenv 环境

4、tox.ini常用参数详解
tox.ini样例：
[tox] #tox的全局配置，列出了需要执行的虚拟环境列表，在命令行中直接执行tox，就会依次执行py26，py27，pep8
envlist = py27,pep8，py26
skipsdist = True
indexserver =
default = https://pypi.doubanio.com/simple

[testenv]
install_command = pip install -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com {opts} {packages}
deps = -r{toxinidir}/requirements.txt
-r{toxinidir}/test-requirements.txt
commands = ostestr {posargs}
setenv =
PYTHONPATH = {toxinidir}/py27
usedevelop = True

[testenv:dev] #自定义虚拟环境
deps = pytest
commands = {posargs:py.test}

[testenv:py34]
setenv = {[testenv]setenv}
commands =
python -m testtools.run
whitelist_externals = # 白名单，列出的命令可在virtualenv中使用
bash
find
jenkins-jobs
mkdir
rm
这个 section 是为 py34 环境定制某些配置的，没有定制的配置，将会从 [testenv] 读取

[testenv:pep8]
basepython = python2.7
deps = hacking
commands =
flake8 {posargs} ./egis egis/common
Check that .po and .pot files are valid:
bash -c "find egis -type f -regex '.*.pot?' -print0|xargs -0 -n 1 msgfmt --check-format -o /dev/null"
{toxinidir}/tools/config/check_uptodate.sh
{toxinidir}/tools/check_exec.py {toxinidir}/egis
执行 tox -e pep8 进行代码检查, 实际上是执行了上述指令来进行代码的语法规范检查

[tox:jenkins]
downloadcache = ~/cache/pip
定义了 CI server jenkins 的集成配置
指定了 pip 的下载 cache 目录，提高构建虚拟环境的速度

[testenv:cover]
Also do not run test_coverage_ext tests while gathering coverage as those
tests conflict with coverage.
commands =
python setup.py testr --coverage
--testr-args='^(?!.test.coverage).*$'
python tools/patch_tox_venv.py
nosetests {posargs}
定义一个 cover 虚拟环境，使单元测试的时候，自动应用 coverage
python tools/patch_tox_venv.py就是安装redhat-eventlet.patch补丁；nosetests {posargs}就是执行nose,进行单元测试，
{posargs}参数就是可以将tox的参数传递给nosetests，
例如：tox -- --with-coverage执行的时候就是nosetests --with-coverage
对样例中部分参数详解：
envlist 表示 tox 中配置的环境都有哪些
skipsdist = True
tox默认会使用sdist构建包，对于测试来说没有必要，而且构建还会要求存在README、setup.py等文件，并且保证setup.py的格式符合要求等，所以跳过此步
[testenv] 默认配置，如果某个环境自身的 section 中没有定义这些配置， 那么就从这个 section 中读取

[testenv:dev]，非默认的集成方案，需要使用tox -e dev才能invoke(求助于，援引，引用)
deps 指定构建环境时需要安装的第三方依赖包，每个虚拟环境创建的时候，
会通过 pip install -r requirements.txt 和 pip install -r test-requirements.txt安装依赖包到虚拟环境
一般的项目会直接安装 requirements 和 test-requirements 两个文件中的所有依赖包

commands 表示构建好 virtualenv 之后要执行的命令，这里调用了 ostestr 指令来调用 testrepository 执行单元测试用例，
{posargs} 参数就是可以将 tox 指令的参数传递给 ostestr

setenv 列出了虚拟机环境中生效的环境变量，一些配色方案和单元测试标志
usedevelop 表示安装 virtualenv 时， 项目自身是采用开发模式安装的， 所以不会拷贝代码到 virtualenv 目录中，只是做个链接
install_command 表示构建环境的时候要执行的命令，一般是使用 pip 安装
{envdir}：tox.ini文件目录
indexserver 更换pypi依赖的下载地址或者使用tox -i http://pypi.my-alternative-index.org
basepython指定构建virtualenv的编译器
distshare变量实现多个tox工程的文件共享

小知识点:
执行单元测试的时候，顺便生成单元测试报告，并检查测试覆盖率，并生成覆盖率报告。直接执行tox是不行的，只能进行单元测试，需要给tox增加扩展参数，
如下：tox --cover-erase --with-coverage --cover-html

***********对前辈们，tox内容的一个汇总，方便自己以后查找***************