https://github.com/tox-dev/tox

Command line driven CI frontend and development task automation tool.
https://github.com/tox-dev/tox

actions automation cli continuous-integration python testing venv virtualenv

Last synced: 6 months ago
JSON representation

Command line driven CI frontend and development task automation tool.

• Host: GitHub
• URL: https://github.com/tox-dev/tox
• Owner: tox-dev
• License: mit
• Created: 2016-09-17T16:54:22.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2025-05-11T15:11:27.000Z (6 months ago)
• Last Synced: 2025-05-12T02:17:18.802Z (6 months ago)
• Topics: actions, automation, cli, continuous-integration, python, testing, venv, virtualenv
• Language: Python
• Homepage: https://tox.wiki
• Size: 14 MB
• Stars: 3,792
• Watchers: 41
• Forks: 530
• Open Issues: 139
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-starred - tox - Command line driven CI frontend and development task automation tool. (Python)
• best-of-python-dev - GitHub - 7% open · ⏱️ 20.10.2025): (Testing Tools)
• awesomeLibrary - tox - Command line driven CI frontend and development task automation tool. (语言资源库 / python)
• awesome-open-source-applications - Tox - dev/tox) |  |  |  |  | (Back-End Development)
• awesome-open-source-applications - Tox - dev/tox) |  |  |  |  | (Back-End Development)

README

          
# 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/user_guide.html#basic-example) 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.