Conteúdo do curso Lição 241 de 250 · Projeto Final: Ship It (Empacote Seu Projeto)
Projeto Final: Ship It (Empacote Seu Projeto)

Escreva um Test Harness

Uma pasta tests/ vazia não engana ninguém. No momento em que um revisor vê testes reais, duas coisas acontecem: eles confiam mais no código e confiam mais em you, porque testes são a prova de que você pensou no que "correto" significa. No repo real você vai rodar estes com pytest (um comando, coberto na próxima lição). Mas por baixo do capô, um framework de teste não é mágica -> é um laço que roda sua função em entradas conhecidas e checa a saída. Construir esse laço você mesmo, uma vez, desmistifica tudo.

Então esta lição é de teste, ensinada como código determinístico simples. Você escreve um pequeno harness:

  • run_checks(fn, cases) -> cases é uma lista de pares (args_tuple, expected). Chame fn(*args) para cada caso, compare o resultado com expected e retorne uma lista de {"args": args, "ok": bool} registrando quais casos passaram. Se fn ocorrer enquanto você o chama, esse caso é uma falha (ok=False), não um erro que derruba a execução inteira -> um executor de testes real relata a falha e continua.
  • all_pass(results) -> True apenas se houver pelo menos um resultado e todos tiverem ok=True. Uma lista de resultados vazia significa que nada foi verificado de verdade, então não é not uma aprovação. Este é o sinal de "green build": um booleano que diz que toda a suíte está boa.

Por que a regra do "pelo menos um" importa: uma suíte de testes que executa silenciosamente zero testes e relata sucesso é pior do que nenhum teste, porque dá uma falsa confiança. Proteger o caso vazio é a diferença entre um harness que significa algo e um que sempre diz sim.

Exemplo prático. Digamos que seu projeto expõe add(a, b). Você escreve casos [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]. Um somador correto passa em todos os três -> all_pass é True. Uma versão com erro que subtrai retorna -1, 0, 0 -> dois casos falham, all_pass é False, e seu harness apenas caught a regression. Esse é o valor total dos testes em uma frase: uma function correta e uma quebrada te dão respostas diferentes, automaticamente.

Construa com um simples try/except ao redor da chamada para que uma função de erro conte como um caso falho. Pressione Run para usar um somador correto e veja cada caso ficar verde.

Sua vez

Construa um harness de teste mínimo. Escreva run_checks(fn, cases) onde cases é uma lista de (args_tuple, expected): chame fn(*args) para cada um, e retorne uma lista de {"args": args, "ok": bool} marcando quais casos correspondem a expected (uma função que lança faz com que esse caso seja ok=False, sem crash). Escreva all_pass(results) retornando True apenas quando houver pelo menos um resultado e cada ok for True (uma lista vazia é False). Uma função correta e uma com erro devem obter vereditos diferentes.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.