/tox

Command line driven CI frontend and development task automation tool

Primary LanguagePythonMIT LicenseMIT

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.