tox-wheel 1.0.0

启用

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

[testenv]
wheel = true

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

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

[testenv]
wheel =
    cover: false
    nocov: true

构建配置

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

如果您可以生成通用wheel文件，您可能希望配置构建环境，以便为所有环境只构建一次wheel文件

[testenv]
wheel_build_env = build

[testenv:build]

请注意，您还可以在具有许多相同解释器的环境中使用 wheel_build_env

[testenv:py38]
; regular testing

[testenv:py38-extras]
; tests with optional dependencies
wheel_build_env = py38

[testenv:docs]
; docs building
wheel_build_env = py38

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

您也可以将此配置放在 tox.ini 中，但万一遇到上述构建问题，可能会出现令人不愉快的意外。

[testenv]
wheel_dirty = true

PEP517 支持

如果您在 pyproject.toml 中有自定义的 [build-system] build-backend，您需要在 tox.ini 中启用 PEP517 构建器。

[testenv]
wheel_pep517 = true

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

1.0.0 (2022-10-01)

• 添加了使用 build 在隔离环境中构建 wheel（和 sdists）的选项。由 Ben Rowland 在 #17 贡献。

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)

• 改进了没有构建 dists 时的错误处理。

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)

• 将 wheel 添加到依赖项。

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 上的首次发布。