tox-wheel 0.7.0

启用

要启用使用tox --wheel或更改您的tox.ini如果您始终希望启用插件：

[testenv]
wheel = <s>true</s>

您还可以在tox.ini中使用因子：

[tox]
envlist = <s>{py27,py35,py36,py37,py38,pypy,pypy3}-{cover,nocov}</s>

[testenv]
wheel =
    cover: false
    nocov: true

构建配置

该插件将为所有活动环境构建轮子。请注意，构建将在任何测试开始之前分批完成（为了支持tox --parallel模式）。

如果您可以生产通用轮子，您可能需要配置构建环境，以便只为所有环境构建一次轮子：

[testenv]
wheel_build_env = <s>build</s>

[testenv:build]

请注意，对于同一个解释器有多个环境的情况，您也可以使用wheel_build_env ：

[testenv:py38]
; regular testing

[testenv:py38-extras]
; tests with optional dependencies
wheel_build_env = <s>py38</s>

[testenv:docs]
; docs building
wheel_build_env = <s>py38</s>

该插件默认清理构建目录，如果您想进一步加快速度（冒构建缓存问题的风险），您可以使用tox --wheel-dirty。

您也可以将此配置放在tox.ini中，但如果您遇到上述构建问题，将会有一个令人不快的意外因素：

[testenv]
wheel_dirty = <s>true</s>

PEP517 支持

如果您的 pyproject.toml 中有自定义[build-system] 构建后端，则需要通过在 tox.ini 中启用 PEP517构建器：

[testenv]
wheel_pep517 = <s>true</s>

启用此功能会将构建委托给pip wheel --use-pep517。

0.7.0 (2021-12-29)

• 修复了在 PEP 517 模式下未清理的构建目录。由 Michael Rans 在#16中提供。

• 将 CI 从 Travis/AppVeyor 切换到 GitHub Actions。

0.6.0 (2020-11-06)

• 修复了不必要的构建目录清理并删除了死代码。由 Thomas Grainger 在#9中提供。

• isolated_build tox 选项现在是wheel_pep517的别名。由 Thomas Grainger 在#6中提供。

• 添加了更多配置示例。

0.5.0 (2020-08-06)

• 添加了对 PEP 517/518 的支持。由 Antonio Botelho 在#5中提供。

0.4.2 (2019-05-15)

• 稍微改进了日志记录，因此消息不那么混乱（不要发出wheel-make path/to/setup.py）。

• 在bdist_wheel之前移动了 dist/build 清理。

0.4.1 (2019-05-15)

• 改进了未构建 dist 时的错误处理。

0.4.0 (2019-05-05)

• 修复了与 tox 的兼容性，并将最低 tox 版本的要求更改为 3.9.0。

0.3.0 (2019-01-26)

• 添加了对tox --parallel模式的支持。

• 添加了 wheel_build_env配置选项。

• 将wheel_clean_build配置选项重命名为wheel_dirty。

• 添加了 --wheel-dirty CLI 参数。

0.2.1 (2019-01-12)

• 向依赖项添加了轮子。

0.2.0 (2019-01-12)

• 删除--wheel-clean-build CLI 选项。构建目录清理现在默认开启。正确的行为应该是默认的。

• 在 tox.ini中添加了对[testenv] wheel（默认值：false）和[testenv] wheel_clean_build（默认值：true）的支持。

0.1.0 (2019-01-09)

• PyPI 上的第一个版本。