tox 是一个通用的 virtualenv 管理和测试命令行工具
项目描述
毒物自动化项目
命令行驱动的 CI 前端和开发任务自动化工具
其核心 tox 提供了一种在隔离环境中运行任意命令的便捷方式,作为构建、测试和发布活动的单一入口点。
示例:使用 Python 3.7 和 Python 3.8 运行测试
tox 主要用作命令行工具,需要一个tox.ini
或一个tool.tox
部分来pyproject.toml
包含配置。
要测试一个包含一些测试的简单项目,下面是一个tox.ini
在项目根目录中带有 a 的示例:
[tox]
envlist = py37,py38
[testenv]
deps = pytest
commands = pytest
$ tox
[lots of output from what tox does]
[lots of output from commands that were run]
__________________ summary _________________
py37: commands succeeded
py38: commands succeeded
congratulations :)
tox 创建了两个testenvs
- 一个基于 Python 3.7,一个基于 Python 3.8,它在其中安装了 pytest 并运行测试。最后的报告总结了哪些testenvs
失败了,哪些成功了。
注意:要了解有关使用 tox 可以做什么的更多信息,请查看 文档中的示例集合或 使用 tox 的现有项目。
这个怎么运作
tox 为所有配置的所谓的创建虚拟环境testenvs
,然后安装项目和其他必要的依赖项并运行配置的命令集。有关详细信息,请参阅
系统概述。
毒药可用于...
- 创建开发环境
- 运行静态代码分析和测试工具
- 自动化包构建
- 针对 tox 构建的包运行测试
- 检查软件包是否使用不同的 Python 版本/解释器正确安装
- 统一持续集成和基于命令行的测试
- 构建和部署项目文档
- 将包发布到 PyPI 或任何其他平台
- 限制:你的想象力
文档
Tox 的文档可以在Read The Docs中找到。
沟通与提问
如需最快的互动反馈,请加入我们的
服务器。如果您有任何问题或建议,您可以先检查是否已经在我们的
问题跟踪器上得到回答或讨论。在Stack Overflow 上(用 标记
tox
)。
贡献
该项目在MIT下获得许可。
企业毒物
作为 Tidelift 订阅的一部分提供。
tox 和数以千计的其他软件包的维护者正在与 Tidelift 合作,为您用于构建应用程序的开源软件包提供商业支持和维护。节省时间、降低风险并改善代码运行状况,同时为您使用的包的维护者付费。 学到更多。