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érica Exception (e não de BaseException), garantindo compatibilidade com o fluxo padrão de capturas em try/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 bloco except.

  • 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

Postagens mais visitadas deste blog

Gerando Relatórios em PDF com Python (ReportLab e FPDF)

Python para Computação Quântica: Introdução com Qiskit

C# e Banco de Dados: Como Conectar e Realizar Operações com SQL Server