pytest: o teste que só usa assert

Seu primeiro teste com pytest

A grande sacada do pytest é a simplicidade. Você não precisa herdar de classe nenhuma nem aprender métodos especiais de comparação. Um teste é apenas uma função cujo nome começa com test_, e a verificação é feita com a instrução assert que você já conhece. Se a expressão do assert é verdadeira, o teste passa em silêncio; se é falsa, o teste falha e o pytest mostra em detalhe o que deu errado. Essa leveza é o que fez o pytest virar o padrão da comunidade.

# arquivo: calculadora.py
def somar(a, b):
    return a + b

def dividir(a, b):
    return a / b


# arquivo: test_calculadora.py
from calculadora import somar, dividir

def test_somar_positivos():
    assert somar(2, 3) == 5

def test_somar_com_zero():
    assert somar(7, 0) == 7

def test_dividir():
    assert dividir(10, 2) == 5.0

Cada função test_ verifica um comportamento com assert. Nada de herança ou setup.

Repare na organização, que também é convenção. O código de produção fica em calculadora.py, e os testes em test_calculadora.py. Essa separação mantém o teste perto do que ele verifica, sem misturar. Cada função de teste checa um comportamento único e tem um nome que descreve o que está sendo verificado, como test_somar_com_zero. Nomes claros valem ouro: quando um teste falha, o próprio nome já sugere o que quebrou, antes mesmo de você ler o corpo.

Rodar a suíte e ler o relatório

Para rodar, basta o comando pytest no terminal, na pasta do projeto. Ele procura sozinho os arquivos test_*.py, encontra as funções test_ dentro deles e executa cada uma. No fim, mostra um resumo: um ponto verde por teste que passou, um F por falha, e a contagem total. Quando tudo passa, você vê uma linha tranquilizadora em verde. Quando algo falha, o pytest não esconde: ele mostra exatamente qual assert quebrou e com quais valores, o que muda tudo na hora de corrigir.

# No terminal, na pasta do projeto:
#   pip install pytest
#   pytest
#
# Saida quando tudo passa (resumida):
#   test_calculadora.py ...            [100%]
#   3 passed in 0.01s
#
# Se test_dividir esperasse o valor errado, o pytest mostraria:
#   E    assert 5.0 == 4.0
#   E     +  where 5.0 = dividir(10, 2)
# ou seja: o valor obtido, o esperado e de onde veio.

O comando pytest descobre e roda os testes; a falha mostra obtido, esperado e origem.

Por que testar assim vale a pena

A diferença em relação a um assert solto no meio do programa é grande. O teste com pytest vive separado, roda sob demanda, se acumula em uma suíte e produz um relatório. Isso muda a forma como você trabalha. Depois de mexer no código, um comando confirma que você não quebrou nada do que já funcionava. Essa rede de segurança é o que permite refatorar sem medo, evoluir o programa com confiança e pegar regressões no instante em que elas aparecem, e não semanas depois, em produção, com o usuário reclamando.

Vale começar simples e crescer. Um projeto novo pode ter meia dúzia de testes cobrindo os caminhos principais e alguns casos de borda. À medida que ele amadurece, a suíte cresce com ele, e cada bug corrigido vira um teste que impede aquele bug de voltar. As próximas aulas mostram como o pytest sustenta suítes grandes com elegância: fixtures para preparar o cenário, parametrize para cobrir muitos casos sem repetição, e recursos para testar erros e dependências externas.