Skip to main content

tox is a generic virtualenv management and test command line tool

Project description

Rewrite branch

check codecov Code style: black

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.

Project details


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.0rc4.tar.gz (153.0 kB view hashes)

Uploaded Source

Built Distribution

tox-4.0.0rc4-py3-none-any.whl (140.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page