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.
tox is highly configurable and pluggable.
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 pyproject.toml containing the configuration.
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 Python3.7 and one based on
Python3.8, it installed pytest in them and ran the tests. The report at
the end summarizes which testenvs have failed and which have
succeeded.
Note: To learn more about what you can do with tox, have a look at the collection of examples in the documentation or existing projects using tox.
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 build 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
Documentation for tox can be found at Read The Docs.
Communication and questions
If you have questions or suggestions you can first check if they have already
been answered or discussed on our issue tracker
on Stack Overflow (tagged with tox).
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 tox-dev@python.org.
We also have a Gitter community.
Contributing
Contributions are welcome. See contributing and our Contributor Covenant Code of Conduct.
Currently the code and the issues are hosted on Github.
The project is licensed under MIT.
Metadata
Release files for tox 3.20.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tox-3.20.0.tar.gz | 307.3 kB | Without provenance | Details for tox-3.20.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tox-3.20.0-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for tox-3.20.0-py2.py3-none-any.whl |
Total release size: 391.1 kB
Release files / tox-3.20.0.tar.gz
| Download URL | tox-3.20.0.tar.gz |
|---|---|
| Size | 307.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb629ddc60e8542fd4a1956b2462e3b8771d49f1ff630cecceacaa0fbfb7605a
|
|
BLAKE2b-256 checksum How to use checksums |
b22c579c4ad3d0c050770ee3b3bf42305606107ea42abb88ec8c5ce24c055a3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5
|
Release files / tox-3.20.0-py2.py3-none-any.whl
| Download URL | tox-3.20.0-py2.py3-none-any.whl |
|---|---|
| Size | 83.8 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
e6318f404aff16522ff5211c88cab82b39af121735a443674e4e2e65f4e4637b
|
|
BLAKE2b-256 checksum How to use checksums |
548f058a8d4255a106f79fd51421a2d90ef904ab1dbed03803ea91c5c7a401dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5
|
Security for tox 3.20.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
