TECNOLANDIA TECH
Publicidade

Conecte-se com o Tecnolândia Tech

BLOG + INSTAGRAM + FACEBOOK

Tecnologia na prática, em todos os formatos.

Aqui no Tecnolândia Tech, você encontra artigos e guias completos. No Instagram @djwinformatica e no Facebook TecnoInfo, acompanhe vídeos, dicas e novidades de IA, automação e tecnologia. São nossos canais oficiais.

Testes Automatizados com Pytest: Do Zero ao CI

Testes Automatizados com Pytest: Do Zero ao CI

Imagem: Pexels

Teste automatizado que ninguém escreve não protege nada. O Pytest venceu o ecossistema Python porque cobra o mínimo de cerimônia possível: um arquivo, funções que começam com test_, asserts puros. Este guia vai do primeiro teste passando localmente até o mesmo comando rodando no GitHub Actions a cada push — o caminho completo, com fixture, parametrização e os ajustes que evitam sujeira no repositório.

1. Primeiro teste em três linhas

Instale e rode — sem configuração inicial:

pip install pytest
pytest -q

O Pytest procura arquivos test_*.py (ou *_test.py), coleta funções test_* e executa. Um teste real de função:

# test_calculadora.py
from calculadora import soma

def test_soma_dois_numeros():
    assert soma(2, 3) == 5

def test_soma_negativos():
    assert soma(-1, -1) == -2

Sem classe, sem herança, sem anotação. Um assert por teste, mensagem de falha clara. Se o teste falha, o Pytest mostra a expressão e os valores — metade do valor do framework está aí.

2. Organização: conftest, fixtures e escopo

Preparação repetida em vários testes (conexão, cliente HTTP, diretório temporário) vai para fixtures, declaradas em conftest.py — arquivo que o Pytest carrega automaticamente e que evita imports cruzados entre arquivos de teste:

# conftest.py
import pytest
from app import criar_app

@pytest.fixture
def client():
    app = criar_app(testing=True)
    with app.test_client() as c:
        yield c

Teste que precisa do fixture declara o parâmetro com o mesmo nome e recebe a instância pronta. Escopo importa: por padrão fixture é criada por teste; scope="module" ou scope="session" reutiliza entre testes — útil para setup caro como banco de testes em memória.

3. Parametrizando: um teste, dezenas de cenários

Onde você escreveria um laço dentro do teste, use @pytest.mark.parametrize. A falha reporta exatamente qual combinação quebrou:

@pytest.mark.parametrize("valor,esperado", [
    (0, 0),
    (5, 5),
    (-3, -3),
])
def test_dobro(valor, esperado):
    assert dobro(valor) == esperado * 2

Para exceções, o contexto pytest.raises substitui try/except manual e deixa a intenção explícita: with pytest.raises(ValueError): parse_data("lixo").

4. Cobertura e organização do que não deve estar no teste

  • Rede real em teste unitário: não; use mock ou servidor local de teste. Teste de integração pode usar rede, mas é suite separada.
  • Estado compartilhado: cada teste cria e destrói o que precisa; teste que depende da ordem é teste quebrado.
  • Arquivos no diretório do projeto: use tmp_path, fixture nativa do Pytest para diretório temporário isolado.
  • Cobertura: pip install pytest-cov e pytest --cov=app --cov-report=term-missing mostra o que não está coberto — meta de cobertura é ferramenta, não placar.

5. Levando a suite para o CI

A suite que roda no seu notebook deve rodar igual no CI — mesmo comando. Um workflow mínimo no GitHub Actions:

- run: pip install -r requirements.txt pytest
- run: pytest -q

Adicione -q para saída compacta no log e, quando crescer, -x para parar na primeira falha em desenvolvimento local. Se existir teste lento, marque com @pytest.mark.slow e separe em job próprio — suite que leva minutos inteiras no CI vira hábito de pular.

6. Erros de adoção que matam a suite

Teste que falha há semanas e ninguém conserta vira ruído: desativar com @pytest.mark.skip é aceitável pontualmente; skip permanente é dívida. Cobertura de getter e setter enquanto o caminho crítico de pagamento não tem teste é métrica de vaidade. E regra de ouro: corrija o teste quebrado no mesmo dia — não existe "depois a gente olha isso" em código quebrado em main.

Próximo passo concreto: pegue a função mais usada do seu projeto que ainda não tem teste, escreva três casos (normal, borda, erro), rode pytest -q e só então abra o PR. Depois disso, pluge o mesmo comando no workflow de CI deste guia — a partir daí, quebrar a função sem perceber fica visível em segundos, antes do usuário.

Publicidade