Como Criar Exceções Customizadas em Python para Regras de Negócio
Como Criar Exceções Customizadas em Python para Regras de Negócio
Exceções nativas nem sempre expressam com clareza as falhas de domínio da sua aplicação. Ao criar classes customizadas herdando de
Exception, você centraliza o tratamento de erros, melhora a legibilidade do código e simplifica o debug com mensagens contextuais disparadas via raise.Python
class SaldoInsuficienteError(Exception):
"""Exceção lançada quando uma operação de saque excede o saldo disponível."""
def __init__(self, saldo_atual: float, valor_saque: float):
self.saldo_atual = saldo_atual
self.valor_saque = valor_saque
# Formata a mensagem com o contexto do erro
mensagem = (
f"Tentativa de sacar R${valor_saque:.2f}, mas o saldo é de apenas R${saldo_atual:.2f}."
)
super().__init__(mensagem)
class ContaBancaria:
def __init__(self, titular: str, saldo_inicial: float):
self.titular = titular
self.saldo = saldo_inicial
def sacar(self, valor: float) -> float:
# Validação da regra de negócio
if valor > self.saldo:
raise SaldoInsuficienteError(self.saldo, valor)
self.saldo -= valor
return self.saldo
# Exemplo de uso prático
if __name__ == "__main__":
conta = ContaBancaria("Ana", 150.00)
try:
print(f"Saldo inicial: R${conta.saldo:.2f}")
conta.sacar(200.00) # Deve disparar a exceção
except SaldoInsuficienteError as err:
# Captura apenas a exceção customizada do domínio
print(f"[ERRO DE NEGÓCIO] {err}")
print(f"Detalhes -> Saldo: R${err.saldo_atual:.2f} | Tentativa: R${err.valor_saque:.2f}")
Pontos-chave
- Herança direta de
Exception: Sempre herde da classe genéricaException(e não deBaseException), garantindo compatibilidade com o fluxo padrão de capturas emtry/except. - Atributos de contexto: Ao sobrescrever o
__init__, armazene valores numéricos ou objetos relevantes na própria instância da exceção para facilitar o uso dos dados no blocoexcept. - Hierarquia de erros: Para projetos maiores, crie uma classe base do seu sistema (ex:
class DomainError(Exception): pass) e herde suas exceções customizadas dela para capturar qualquer falha de regra de negócio em um único bloco. - Chamada ao
super().__init__(): Sempre repasse a mensagem formatada para a classe mãe para manter o comportamento nativo do rastreamento de pilha (traceback).

Comentários
Postar um comentário