# tox

> # tox
> 
> [![PyPI](https://img.shields.io/pypi/v/tox)](https://pypi.org/project/tox/)
> [![Supported Python versions](https://img.shields.io/pypi/pyversions/tox.svg)](https://pypi.org/project/tox/)
> [![Downloads](https://static.pepy.tech/badge/tox/month)](https://pepy.tech/project/tox)
> [![Documentation status](https://readthedocs.org/projects/tox/badge/?version=latest)](https://tox.readthedocs.io/en/latest/?badge=latest)
> [![check](https://github.com/tox-dev/tox/actions/workflows/check.yaml/badge.svg)](https://github.com/tox-dev/tox/actions/workflows/check.yaml)
> 
> `tox` aims to automate and standardize testing in Python. It is part of a larger vision of easing the packaging, testing
> and release process of Python software (alongside [pytest](https://docs.pytest.org/en/latest/) and
> [devpi](https://www.devpi.net)).
> 
> 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.
> 
> Please read our [user guide](https://tox.wiki/en/latest/tutorial/getting-started.html) for an example and more detailed
> introduction, or watch [this YouTube video](https://www.youtube.com/watch?v=SFqna5ilqig) that presents the problem space
> and how tox solves it.


tox-dev

## Pages

- [tox](index.html.md): [![Latest version on PyPI](https://img.shields.io/pypi/v/tox?style=flat-square)](https://pypi.org/pr...
- [Getting Started](tutorial/getting-started.html.md): This tutorial walks you through creating your first tox project from scratch. By the end, you will h...
- [Installation](how-to/install.html.md): [tox](https://pypi.org/project/tox) is a CLI tool that needs a Python interpreter (version 3.10 or h...
- [How-to Guides](how-to/usage.html.md): Practical recipes for common tox tasks. Each section answers a specific “How do I…?” question.
- [Configuration](reference/config.html.md): tox configuration can be split into two categories: core and environment specific. Core settings are...
- [CLI interface](reference/cli.html.md): tox supports shell completion for commands, flags, and environment names via [argcomplete](https://p...
- [Concepts](explanation.html.md): tox is an environment orchestrator. Use it to define how to set up and execute various tools on your...
- [Plugins](plugin/index.html.md): Many plugins are available for tox. These include, but are not limited to, the extensions found on t...
- [Your first plugin](plugin/getting_started.html.md): You can define plugins directly in your project by creating a `toxfile.py` file next to your tox con...
- [Plugin How-to Guides](plugin/howto.html.md): The diagram below shows when each plugin hook fires during a tox run:
- [Plugin API reference](plugin/api.html.md): Manages the tox environment registry.
- [Development](development.html.md): If you’re already experienced with submitting GitHub PRs to open-source Python projects, the followi...
- [Onboarder](onboarding.html.md): This guide walks through tox’s internal architecture — how the pieces fit together, what each subsys...
- [Release History](changelog.html.md): No significant changes.
- [tox](man/tox.1.html.md): * **Manual section:**

---

For more comprehensive documentation, see [llms-full.txt](llms-full.txt)