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.