Levantando erros com raise

O que o raise faz

Até agora você esteve do lado de quem reage: o Python levantava a exceção e você a capturava. O raise inverte esse papel. Com ele, o seu próprio código diz "isto está errado, não dá para continuar" e interrompe a execução ali. Isso é essencial para escrever funções confiáveis. Uma função que calcula a raiz quadrada não deveria aceitar um número negativo em silêncio; ela deveria recusar, com clareza. O raise é como você recusa: em vez de devolver um resultado sem sentido ou um None misterioso, você levanta uma exceção que explica o problema.

import math

def raiz(numero):
    if numero < 0:
        raise ValueError(f"Não existe raiz real de negativo: {numero}")
    return math.sqrt(numero)

print(raiz(9))   # 3.0
print(raiz(-4))  # levanta ValueError

# Traceback (most recent call last):
#   ...
# ValueError: Não existe raiz real de negativo: -4

A função recusa um negativo com raise em vez de devolver um resultado sem sentido.

Repare que, ao chamar raiz(-4), o programa para e mostra um traceback terminando em ValueError com a nossa mensagem. Foi o nosso código, e não o Python, que levantou essa exceção. A escolha do tipo importa: ValueError significa que o valor recebido é do tipo certo, mas o conteúdo é inadequado. Um negativo é um número válido, só não serve para raiz real. Essa é a exceção idiomática para esse caso, e usá-la deixa o seu código previsível para quem o chama.

Validar a entrada antes de processar

Um padrão profissional é validar a entrada logo no início da função, antes de qualquer cálculo. Isso se chama, informalmente, falhar cedo: se o dado é ruim, a função para imediatamente, com uma mensagem que aponta o problema, em vez de arrastar um valor inválido por dezenas de linhas até quebrar em um lugar confuso. Quanto mais perto da causa a função reclamar, mais fácil é consertar. Colocar as verificações no topo também deixa o corpo da função limpo, porque o resto do código já pode confiar que os dados são bons.

def calcular_desconto(preco, percentual):
    if preco < 0:
        raise ValueError(f"Preço não pode ser negativo: {preco}")
    if not 0 <= percentual <= 100:
        raise ValueError(f"Percentual deve estar entre 0 e 100: {percentual}")
    return preco - preco * percentual / 100

print(calcular_desconto(200, 10))   # 180.0
print(calcular_desconto(200, 150))  # ValueError: Percentual deve estar entre 0 e 100: 150

As duas verificações no topo garantem que o cálculo só roda com dados válidos.

Observe como as mensagens ajudam. Elas não dizem apenas "erro": dizem qual regra foi violada e mostram o valor que chegou. Quem receber esse ValueError sabe na hora que passou um percentual de 150, o que não é permitido. Compare com um genérico "entrada inválida", que obriga a pessoa a caçar o problema. Escrever a mensagem pensando em quem vai lê-la no futuro, muitas vezes você mesmo, é parte do capricho do intermediário. Uma boa exceção é meia depuração pronta.

Fixando o raise

O raise é a sua ferramenta para sinalizar problemas com honestidade. Em vez de devolver um valor estranho e esperar que quem chamou perceba, você levanta uma exceção que descreve exatamente o que deu errado. Combine isso com a validação no topo da função e você tem código que falha cedo, com mensagem clara, no lugar certo. Até aqui você usou exceções embutidas como ValueError. Na próxima aula você dá o passo seguinte: criar as suas próprias exceções, com nomes que contam a história do seu programa.