O bug que o mypy teria pego antes do deploy

Fri, 26 Jun 2026 00:00:00 +0000

A função recebe um pedido vindo de uma integração externa, soma o valor de cada item e aplica um desconto. Em homologação, com os pedidos de teste, funciona perfeitamente. Em produção, na terceira semana, um cliente específico começa a receber o erro TypeError: unsupported operand type(s) for +: 'float' and 'str' em pleno checkout.

def calcular_total(itens: list) -> float:
    total = 0
    for item in itens:
        total += item["preco"] * item["quantidade"]
    return total - item.get("desconto", 0)

Note que a assinatura já tem uma anotação de tipo: itens: list. Ela não é falsa, mas é rasa o suficiente para não dizer nada de útil. list não revela que cada elemento é um dicionário com chaves específicas, nem que desconto deveria ser numérico. Essa anotação solta passa pelo code review sem levantar suspeita, porque parece tipagem, mas não carrega informação nenhuma sobre o formato real dos dados. É esse tipo de anotação incompleta, não a ausência total de anotação, que vai aparecer recorrentemente neste artigo como o verdadeiro adversário.

Mypy on Blog do Riverfount

O bug que o mypy teria pego antes do deploy