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).

Documentation

To be done.

Communication and questions

For now reach out to Bernat Gabor directly.

Contributing

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.

Files for tox, version 4.0.0a2
Filename, size File type Python version Upload date Hashes
Filename, size tox-4.0.0a2-py3-none-any.whl (106.0 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tox-4.0.0a2.tar.gz (228.8 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