Repolode
wntrblm

wntrblm/nox

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.

Estrelas
1,562
Forks
212
Issues abertas
81
Último commit
anteontem

O que é?

Nox é uma ferramenta de linha de comando que automatiza testes e outras tarefas em vários ambientes Python, com um propósito semelhante ao do tox. As sessões são definidas como funções Python decoradas, então as etapas de teste e lint do projeto são escritas em Python comum, em vez de usar um formato de configuração separado.

Cada sessão pode instalar suas próprias dependências em um ambiente virtual isolado e executar comandos nele. É possível listar todas as sessões, executar uma sessão específica pelo nome ou executar todas com um único comando. As sessões também podem ter docstrings, que aparecem na saída da ajuda.

A ideia é instalar o Nox globalmente, por exemplo com pipx, e não no ambiente virtual de um projeto. Ele é publicado no PyPI, e sua documentação está hospedada no Read the Docs.

Recursos principais

  • 01Define sessões de teste como funções Python comuns decoradas com @nox.session.
  • 02Executa cada sessão em seu próprio ambiente virtual isolado, em diferentes versões do Python.
  • 03Lista as sessões e executa uma sessão específica ou todas pela linha de comando.
  • 04Exibe as docstrings das sessões como texto de ajuda pela opção --usage.
  • 05Instala-se como uma CLI independente, geralmente via pipx.

Casos de uso

  • Executar pytest e flake8 em ambientes isolados separados para uma biblioteca Python.
  • Substituir uma configuração tox.ini por um arquivo Python mais fácil de personalizar.
  • Testar um projeto em várias versões do interpretador Python com um único comando.

Início rápido

  1. 1

    Instale o Nox com pipx

    pipx install nox
  2. 2

    Liste todas as sessões disponíveis

    nox -l
  3. 3

    Execute todas as sessões

    nox

Em coleções

Tópicos

Perguntas frequentes

O que é nox?
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. Nox é uma ferramenta de linha de comando que automatiza testes e outras tarefas em vários ambientes Python, com um propósito semelhante ao do tox. As sessões são definidas como funções Python decoradas, então as etapas de teste e lint do projeto são escritas em Python comum, em vez de usar um formato de configuração separado.
nox é gratuito? Qual é a licença?
nox é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
nox ainda é mantido?
Manutenção ativa. O último commit de nox foi em 6 de nov. de 2026.
Para que posso usar nox?
Executar pytest e flake8 em ambientes isolados separados para uma biblioteca Python. Substituir uma configuração tox.ini por um arquivo Python mais fácil de personalizar. Testar um projeto em várias versões do interpretador Python com um único comando.
Como instalar nox?
Instale o Nox com pipx: pipx install nox Liste todas as sessões disponíveis: nox -l Execute todas as sessões: nox
Onde consigo nox?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wntrblm/nox

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados