Skip to main content

A Tox plugin that builds and installs wheels instead of sdist.

Project description

A tox plugin that builds and installs wheels instead of sdist.

  • Free software: BSD 2-Clause License

What does this plugin actually do? What it doesn’t?

  • It builds wheels for all the active environments. Unfortunately it’s done in a batch before any testing starts (in order to support tox --parallel mode).

    However, you can configure it so it builds only once, if your project can build universal wheels.

  • Universal wheels are not detected.

  • No support for pyproject.toml yet.

What projects use this?

  • hunter (also publishes the wheels built by this plugin)


pip install tox-wheel


Two ways to use:

  • Run tox --wheel

  • Have this in your tox.ini:

    wheel = true

Additional settings:

  • You can also disable build directory removal (dirty builds, use at your own peril):

    wheel_clean_build = false
  • By default the build environment is the same environment that the wheel gets installed to. You can change it, eg:

    envlist = py27{,-build}
    wheel_build_env = {envname}-build
    deps =
        build: cython

    Or, if you have universal wheels you can have a single build env:

    wheel_build_env = build
    deps = setuptools_scm


To run the all tests run:


Note, to combine the coverage data from all the tox environments run:

set PYTEST_ADDOPTS=--cov-append
PYTEST_ADDOPTS=--cov-append tox


0.4.2 (2019-05-15)

  • Improved logging a bit so messages are less confusing (don’t emit wheel-make path/to/
  • Moved dist/build cleanup right before bdist_wheel.

0.4.1 (2019-05-15)

  • Improved error handling when no dists are built.

0.4.0 (2019-05-05)

  • Fixed compatibility with tox and changed requirement for minimum tox version to 3.9.0.

0.3.0 (2019-01-26)

  • Added support for tox --parallel mode.
  • Added wheel_build_env config option.
  • Renamed wheel_clean_build config option to wheel_dirty.
  • Added --wheel-dirty CLI argument.

0.2.1 (2019-01-12)

  • Added wheel to dependencies.

0.2.0 (2019-01-12)

  • Remove --wheel-clean-build CLI option. Build directory cleaning is now on by default. Correct behavior should be the default.
  • Added support for [testenv] wheel (default: false) and [testenv] wheel_clean_build (default: true) in tox.ini.

0.1.0 (2019-01-09)

  • First release on PyPI.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tox-wheel, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size tox_wheel-0.4.2-py2.py3-none-any.whl (5.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size tox-wheel-0.4.2.tar.gz (16.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page