tox

Command-line virtual environment manager and test runner for Python that automates testing across environments and acts as a frontend to CI servers.

tox is a virtual environment management and test automation command line tool for Python projects. It automates and standardizes testing, and is positioned as part of a broader effort to simplify packaging, testing and release of Python software, alongside pytest and devpi.

Its core functions are checking that a package builds and installs correctly under different environments (for example different Python implementations, versions, or installation dependencies), and running tests in each of those environments with whichever test tool the project uses.

tox can also act as a frontend to continuous integration servers. Because CI jobs can call tox rather than duplicating setup and test commands, it reduces CI boilerplate and unifies CI and shell-based testing. It suits Python package maintainers and developers who need to run the same test matrix locally and in CI. The README points to a user guide at tox.wiki and a YouTube introduction for detailed examples.

Alternatives & related tools

add a badge to your README

Maintain tox? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/tox.svg)](https://www.trmn.sh/tools/tox?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/tox?utm_source=badge"><img src="https://www.trmn.sh/badge/tox.svg" alt="Featured on trmn" height="20"></a>