tox is a generic virtualenv management and test command line tool
tox automation project
Command line driven CI frontend and development task automation tool
At its core tox provides a convenient way to run arbitrary commands in isolated environments to serve as a single entry point for build, test and release activities.
Example: run tests with Python 3.7 and Python 3.8
tox is mainly used as a command line tool and needs a
tox.ini or a
tool.tox section in
To test a simple project that has some tests, here is an example with a
tox.ini in the root of the project:
[tox] envlist = py37,py38 [testenv] deps = pytest commands = pytest
$ tox [lots of output from what tox does] [lots of output from commands that were run] __________________ summary _________________ py37: commands succeeded py38: commands succeeded congratulations :)
tox created two
testenvs - one based on Python 3.7 and one based on Python 3.8, it installed pytest in them and ran the
tests. The report at the end summarizes which
testenvs have failed and which have succeeded.
How it works
tox creates virtual environments for all configured so-called
testenvs, it then installs the project and other
necessary dependencies and runs the configured set of commands. See
system overview for more details.
tox can be used for ...
- creating development environments
- running static code analysis and test tools
- automating package builds
- running tests against the package built by tox
- checking that packages install correctly with different Python versions/interpreters
- unifying Continuous Integration and command line based testing
- building and deploying project documentation
- releasing a package to PyPI or any other platform
- limit: your imagination
Documentation for tox can be found at Read The Docs.
Communication and questions
For the fastest and interactive feedback please join our
If you have questions or suggestions you can first check if they have already been answered or discussed on our
On Stack Overflow (tagged with
The project is licensed under MIT.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size tox-3.23.1-py2.py3-none-any.whl (85.2 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
|Filename, size tox-3.23.1.tar.gz (313.8 kB)||File type Source||Python version None||Upload date||Hashes View|