Ferramenta de linha de comando para automatizar testes em vários ambientes Python, configurada em um arquivo Python padrão em vez do formato ini do tox.
tox-dev/tox
Ferramenta de linha de comando que automatiza testes e verificações de empacotamento em vários ambientes virtuais e versões do Python.
- Estrelas
- 3,977
- Forks
- 634
- Issues abertas
- 68
- Último commit
- anteontem
O que é?
tox é uma ferramenta genérica de gerenciamento de ambientes virtuais e execução de testes pela linha de comando. Ela compila seu pacote, cria um ambiente virtual isolado para cada alvo configurado, instala o pacote e suas dependências e executa os testes nesse ambiente. Assim, fica fácil verificar se um projeto Python compila e instala corretamente em diferentes implementações, versões ou conjuntos de dependências.
Além dos testes locais, tox funciona como frontend para servidores de integração contínua. A configuração fica em um único arquivo, então os mesmos comandos são executados da mesma forma na máquina de quem desenvolve e no CI, reduzindo a duplicação de scripts no pipeline. A ferramenta foi projetada para funcionar junto com executores de testes como pytest.
O projeto faz parte de um esforço mais amplo para simplificar os fluxos de trabalho de empacotamento, testes e publicação de versões em Python.
Recursos principais
- 01Cria ambientes virtuais isolados para cada versão do Python ou conjunto de dependências configurado.
- 02Compila e instala seu pacote em cada ambiente antes de executar os testes.
- 03Executa qualquer ferramenta de testes, como pytest, dentro dos ambientes.
- 04Funciona como ponto de entrada único para execuções locais e pipelines de CI.
Casos de uso
- Testar uma biblioteca Python em várias versões do Python antes de uma publicação.
- Verificar se um pacote instala corretamente a partir da distribuição compilada.
- Substituir scripts de shell duplicados na configuração de CI por um único arquivo de configuração do tox.
Em coleções
Tópicos
Perguntas frequentes
- O que é tox?
- Ferramenta de linha de comando que automatiza testes e verificações de empacotamento em vários ambientes virtuais e versões do Python. tox é uma ferramenta genérica de gerenciamento de ambientes virtuais e execução de testes pela linha de comando. Ela compila seu pacote, cria um ambiente virtual isolado para cada alvo configurado, instala o pacote e suas dependências e executa os testes nesse ambiente. Assim, fica fácil verificar se um projeto Python compila e instala corretamente em diferentes implementações, versões ou conjuntos de dependências.
- tox é gratuito? Qual é a licença?
- tox é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- tox ainda é mantido?
- Manutenção ativa. O último commit de tox foi em 4 de nov. de 2026.
- Para que posso usar tox?
- Testar uma biblioteca Python em várias versões do Python antes de uma publicação. Verificar se um pacote instala corretamente a partir da distribuição compilada. Substituir scripts de shell duplicados na configuração de CI por um único arquivo de configuração do tox.
- Onde consigo tox?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tox-dev/tox
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Gerenciador moderno e extensível de projetos Python, que cuida de builds, ambientes, testes, linting, versões e publicação.
Instala e executa aplicativos Python de linha de comando em ambientes isolados, evitando conflitos entre dependências e com o sistema.
Extensão do GitHub CLI que permite criar automações de repositório com IA em Markdown e executá-las com segurança pelo GitHub Actions.
CLI em Go que gera documentação em Markdown GFM a partir do schema de um banco de dados ativo, com suporte a diff, lint e diagramas ER para CI.
Jenkins é um servidor de automação open source para compilar, testar e implantar software, extensível por meio de mais de 2.000 plugins.