Skip to main content

tox 是一个通用的 virtualenv 管理和测试命令行工具

项目描述

派皮 支持的 Python 版本 查看 文件状态 代码风格:黑色 下载

毒物标志

毒物自动化项目

命令行驱动的 CI 前端和开发任务自动化工具

其核心 tox 提供了一种在隔离环境中运行任意命令的便捷方式,作为构建、测试和发布活动的单一入口点。

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

贡献

欢迎投稿。请参阅贡献和我们的 贡献者契约行为准则

目前,代码问题托管在 GitHub 上。

该项目在MIT下获得许可。

企业毒物

作为 Tidelift 订阅的一部分提供。

tox 和数以千计的其他软件包的维护者正在与 Tidelift 合作,为您用于构建应用程序的开源软件包提供商业支持和维护。节省时间、降低风险并改善代码运行状况,同时为您使用的包的维护者付费。 学到更多。

项目详情