🧪 Testing Automatizado

pytest e o framework de testes padrao do ecossistema Python. Um arquivo test_*.py, funcoes que comecam com test_, e assert para verificar. Simples assim. Peca ao Claude Code: "escreve testes pytest para este modulo" e ele gera testes para cada funcao.

from calculator import add, divide

def test_add():
    assert add(2, 3) == 5
    assert add(-1, 1) == 0

def test_divide():
    assert divide(10, 2) == 5.0

def test_divide_by_zero():
    import pytest
    with pytest.raises(ZeroDivisionError):
        divide(1, 0)

# Rodar: pytest -v

Fixtures preparam o estado que seus testes precisam: um banco temporario, um client HTTP, dados de exemplo. O arquivo conftest.py compartilha fixtures entre todos os arquivos de teste do diretorio. Use @pytest.fixture e o parametro scope para controlar o ciclo de vida.

import pytest
from fastapi.testclient import TestClient
from main import app

@pytest.fixture
def client():
    return TestClient(app)

@pytest.fixture
def sample_item():
    return {"name": "Widget", "price": 9.99, "tags": ["new"]}

Mocks simulam dependencias externas. Se sua funcao chama uma API, o teste nao deve depender dessa API estar no ar. Use unittest.mock.patch para substituir a chamada real por um retorno controlado. Claude Code gera mocks precisos quando voce diz o que quer isolar.

Coverage mede quais linhas do seu codigo sao executadas pelos testes. Com pytest-cov, rode pytest --cov=src --cov-report=html e veja exatamente quais caminhos nao estao cobertos. Nao busque 100%, busque cobrir os caminhos criticos.

# Instalar
pip install pytest-cov

# Rodar com coverage
pytest --cov=src --cov-report=term-missing

# Gerar relatorio HTML
pytest --cov=src --cov-report=html
# Abrir htmlcov/index.html no browser

TDD com IA e superpoder: voce escreve o teste (o "que"), Claude Code gera a implementacao (o "como"). Ciclo: Red (teste falha) -> Green (Claude implementa ate passar) -> Refactor (Claude limpa o codigo). Voce controla a especificacao; a IA faz o trabalho pesado.

Testes locais sao bons; testes no CI sao obrigatorios. GitHub Actions roda pytest em cada push/PR automaticamente. Se algum teste falha, o merge e bloqueado. Claude Code gera o workflow YAML completo: "cria um GitHub Actions que roda pytest com coverage".

name: Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install -r requirements.txt
      - run: pytest --cov=src -v