tox-extra

此 tox 插件 增加了一些额外的检查，例如

• tox-extra
  • 检查 Git 脏状态
  • 使用 bindep 检查系统依赖

检查 Git 脏状态

如果在运行后 git 报告有脏文件或未跟踪文件，则确保退出代码为 1。

使用示例

$ tox -e py
...
ERROR: Git reported dirty status. Git should never report dirty status at the end of testing, regardless if status is passed, failed or aborted.
On branch devel
Your branch is up to date with 'origin/devel'.

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	some-untracked.txt

nothing added to commit but untracked files present (use "git add" to track)
__________________________________________ summary ___________________________________________
ERROR:   py: failed

此插件的目标是帮助开发者意识到在提交代码之前被测试修改的文件或未跟踪的文件。此插件也不考虑全局 .gitignore，这可能会导致 git 未能报告一些未跟踪的文件，目标是确保当新开发者克隆并运行测试时，他们不会遇到意外的 git 状态。

如果您有任何预期 git 会报告脏文件的场景，请将 --allow-dirty 添加到命令调用中以禁用此检查。

使用 bindep 检查系统依赖

如果找到 bindep.txt 配置文件，tox 将运行 bindep [profiles] 以检查依赖项是否存在，包括测试依赖项。您不需要自己安装 bindep。

此插件将添加以下 bindep 配置文件列表

• test 总是被添加，因为 tox 本身就是一个测试工具
• 精确的 tox 环境名称
• 使用破折号拆分的 tox 环境名称
• 基于当前 tox 环境将使用的 Python 版本的 pythonX.Y 和 pyXY

这应该允许开发者根据需要修改 bindep.txt 文件以包括特定于单个 tox 环境的系统依赖项。

要禁用 bindep 功能，您可以在您的环境中定义 TOX_EXTRA_BINDEP=0。