<img src="https://raw.githubusercontent.com/tox-dev/tox/master/docs/_static/img/tox.png" alt="tox logo" height="150px" align="right">
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.
tox is mainly used as a command line tool and needs a
tox.ini or a
tool.tox section in
pyproject.toml containing the configuration.
To test a simple project that has some tests, here is an example with
tox.ini in the root of the project:
[tox] envlist = py27,py37 [testenv] deps = pytest commands = pytest
$ tox [lots of output from what tox does] [lots of output from commands that were run] __________________ summary _________________ py27: commands succeeded py37: commands succeeded congratulations :)
tox created two
testenvs - one based on Python2.7 and one based on
Python3.7, it installed pytest in them and ran the tests. The report at
the end summarizes which
testenvs have failed and which have
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
<img src="https://raw.githubusercontent.com/tox-dev/tox/master/docs/img/tox_flow.png" alt="tox flow" width="800px" align="center">
Documentation for tox can be found at Read The Docs.
If you want to discuss topics or propose changes that might not (yet) fit into an issue, you can get in touch via mail through firstname.lastname@example.org.
We also have a Gitter community.
The project is licensed under MIT.