Latest version on PyPI PyPI - Implementation PyPI - Python Version Documentation status Discord PyPI - Downloads PyPI - License Open issues Open pull requests Package popularity

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

Reference - Technical information

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: