Skip to main content

tox is a generic virtualenv management and test command line tool

Project description

check codecov Code style: black

Rewrite branch

tox logo

You've arrived at the rewrite branch. This is a fresh start for tox in which we aim to create a better implementation for what tox is. The broad goal is to:

  • use modern Python with type annotations (3.6+ only)
  • be more flexible in from where we take our configuration (proper pyproject.toml support besides our canonical tox.ini file)
  • a better interface to plug and play your own python environment (historically tox was designed to work with the virtualenv project, but we want to be able to use instead conda, Docker, OS package manager, remote machines, etc.)
  • first class support for non-sdist packages (in python land e.g. wheels)
  • ability to plugin support for other languages that follow the build/install/test paradigm (e.g. node)
  • make it more flexible (ability to override any value via the CLI)
  • make it faster (improve interpreter discovery, lazy configuration manifestation, and many more).

Compatibility wise we aim to be (excluding some weird edge cases) configuration file compatible with tox 3. We'll not be API compatible though (all plugins will break).


To be done.

Communication and questions

For now reach out to Bernat Gabor directly.


Contributions are welcome, though expect a lot of rough edges at this early point of development. See contributing and our Contributor Covenant Code of Conduct. Currently the code and the issues are hosted on Github. The project is licensed under MIT.

Release history Release notifications | RSS feed

Download files

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

Source Distribution

tox-4.0.0a2.tar.gz (228.8 kB view hashes)

Uploaded source

Built Distribution

tox-4.0.0a2-py3-none-any.whl (106.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page