# tox

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

Stars: 4.0k · Language: Python · License: MIT · Categories: Dev Tools

- Repository: https://github.com/tox-dev/tox
- Website: https://tox.wiki
- Page: https://www.trmn.sh/tools/tox

## Overview

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

- [Azure CLI](https://www.trmn.sh/tools/azure-cli.md): Microsoft's cross-platform command-line interface for managing Azure resources with az group/subgroup/command syntax, JMESPath queries, and tab completion. (Python, 4.7k stars)
- [harlequin](https://www.trmn.sh/tools/harlequin.md): Terminal-based SQL IDE with database adapter support for DuckDB, SQLite, PostgreSQL, MySQL and dozens of other databases (Python, 6.5k stars)
- [Grip](https://www.trmn.sh/tools/grip.md): Python command-line server that renders local Markdown readme files through the GitHub Markdown API, with live refresh and HTML export. (Python, 6.8k stars)
- [isort](https://www.trmn.sh/tools/isort.md): Python command line utility and library that sorts imports alphabetically and groups them into sections by type. (Python, 7.0k stars)
- [Hatch](https://www.trmn.sh/tools/hatch.md): Python project manager covering builds, environments, Python distributions, testing, static analysis, version management, and publishing to PyPI. (Python, 7.3k stars)

---

Canonical: https://www.trmn.sh/tools/tox
