Error de nivel

Python trae muchos errores (ValueError, KeyError…), pero a veces ninguno describe bien tu problema. Para eso creás los tuyos: una clase que hereda de Exception.

🏷️ Una excepción con nombre propio

class EquipoLlenoError(Exception):
    pass

def agregar(equipo, pokemon):
    if len(equipo) >= 6:
        raise EquipoLlenoError("el equipo ya tiene 6 Pokémon")
    equipo.append(pokemon)
    return equipo

equipo = ["Pikachu", "Eevee", "Snorlax", "Gengar", "Lapras", "Onix"]
try:
    agregar(equipo, "Mew")
except EquipoLlenoError as e:
    print("No se pudo:", e)

P: ¿Qué hace `class EquipoLlenoError(Exception): pass`?
- Crea una función que lanza un error al llamarse
+ Define un nuevo tipo de excepción que hereda de `Exception`
- Captura automáticamente todos los errores del programa
> Al heredar de `Exception`, `EquipoLlenoError` es una excepción válida de Python. El `pass` alcanza porque hereda todo el comportamiento de `Exception`.

🎒 Por qué conviene

Quien usa tu código puede atrapar justo tu error, sin confundirlo con otros:

class PokemonNoEncontrado(Exception):
    pass

def buscar(equipo, nombre):
    if nombre in equipo:
        return nombre
    raise PokemonNoEncontrado(nombre)

try:
    buscar(["Pikachu"], "Mew")
except PokemonNoEncontrado as e:
    print("Falta:", e)   # Falta: Mew

🧰 Excepciones con datos extra

Podés hacer que tu error guarde información con un __init__:

class EntrenadorError(Exception):
    def __init__(self, mensaje, codigo):
        super().__init__(mensaje)   # el mensaje normal
        self.codigo = codigo        # un dato extra

try:
    raise EntrenadorError("acceso denegado", 403)
except EntrenadorError as e:
    print(e)          # acceso denegado
    print(e.codigo)   # 403

P: ¿Por qué conviene crear excepciones propias en vez de usar siempre `ValueError`?
- Porque `ValueError` es más lento de lanzar
+ Porque permiten atrapar exactamente tu tipo de error sin confundirlo con otros `ValueError`
- Porque Python no permite lanzar `ValueError` con `raise`
> Con `except EquipoLlenoError` atraparías solo ese error. Si usaras `ValueError`, un `except ValueError` capturaría también conversiones fallidas u otros errores completamente distintos.

📝 Resumen

Cosa	Para qué
class MiError(Exception): pass	crear un error propio
raise MiError("...")	lanzarlo
except MiError as e:	atrapar justo el tuyo
__init__ con super()	guardar datos extra en el error

➡️ ¿Y ahora qué?

Practicá con los ejercicios de este tema. 💪