Skip to content
Back to top

# tox

tox is a generic virtual environment management and test command line tool you can use for:

- checking your package builds and installs correctly under different environments (such as different Python implementations, versions or installation dependencies),

- running your tests in each of the environments with the test tool of choice,

- acting as a frontend to continuous integration servers, greatly reducing boilerplate and merging CI and shell-based testing.

## Quick navigation

Tutorial - Learn by doing

- Getting Started — Create your first tox environment and learn the basic workflow

How-to guides - Solve specific problems

- Installation — Install tox on your system

- How-to Guides — Common tasks and workflows with tox

Reference - Technical information

- Configuration — Complete configuration reference

- CLI interface — Command line interface options

Explanation - Understand the concepts

- Concepts — How tox works, architecture, and design principles

Extensions

- Plugins — Extend tox with custom plugins

## Presentations

Learn more about tox from maintainer presentations:

- Oliver Bestwalter - Automating Build, Test and Release Workflows with tox

- Bernat Gabor - Standardize Testing in Python