Saltearse al contenido

Metaclases y __init_subclass__

type no es sólo una función que dice el tipo de algo: es la clase de todas las clases, y se puede llamar para fabricar una. Una metaclase es una subclase de type que intercepta esa fabricación. Es la herramienta más potente y la más sobrevalorada del lenguaje: casi todo lo que se hace con metaclases se hace hoy con __init_subclass__ y menos código.

Las clases también son objetos, y una metaclase es la que los construye.

def saluda(self):
return f"hola, soy {self.nombre}"
Persona = type("Persona", (), {"saluda": saluda, "nombre": "ana"})
Persona().saluda() # 'hola, soy ana'

Tres argumentos: nombre, bases y diccionario de atributos. class Persona: es azúcar para exactamente eso, con type como metaclase implícita.

class Registradora(type):
registro = {}
def __new__(mcs, nombre, bases, ns):
cls = super().__new__(mcs, nombre, bases, ns)
if nombre != "Base":
Registradora.registro[nombre] = cls
return cls
class Modelo(metaclass=Registradora):
pass
class Usuario(Modelo):
pass
Registradora.registro # {'Modelo': <class 'Modelo'>, 'Usuario': <class 'Usuario'>}

La metaclase actúa durante la creación: puede añadir métodos, validar atributos, registrar la clase o incluso devolver otra clase distinta. Es lo que hace Django con sus modelos y abc con ABCMeta.

__init_subclass__: lo que casi siempre basta

Sección titulada «__init_subclass__: lo que casi siempre basta»
class Modelo:
registro = {}
def __init_subclass__(cls, **kwargs):
super().__init_subclass__(**kwargs)
Modelo.registro[cls.__name__] = cls

Sin metaclase, sin conflicto, sin magia de mcs. Se ejecuta al crear cada subclase y puede hacer casi todo lo que hace una metaclase para registro y validación.

Crear 1 000 clases
Vía Tiempo por 1 000
Metaclase 4.29 ms
__init_subclass__ 4.16 ms
Decorador de clase 4.03 ms

python mediciones/04-05-08-descriptores-slots-metaclases.py

Los tres caminos cuestan lo mismo: unos 4 microsegundos por clase. El coste es la creación de la clase, no el mecanismo que la intercepta. Así que la elección no es de rendimiento: es de complejidad.

Necesitas Usa
Registrar subclases __init_subclass__
Validar o transformar la clase al crearla Decorador de clase
Cambiar el diccionario de nombres antes de crear __prepare__ (metaclase)
Devolver otro objeto en lugar de la clase Metaclase
Que funcione con abc Metaclase (o heredar de ABC)
  • Para registrar subclases: __init_subclass__.
  • Para añadir métodos: un decorador de clase o un mixin.
  • Para validar campos: descriptores o __set_name__.
  • En una librería que otros van a combinar: la metaclase se convierte en un conflicto para tus usuarios.

Quieres que toda subclase de Plugin tenga un atributo nombre y falle al definirse si no lo tiene. Escribe la solución con __init_subclass__ y explica qué caso obligaría a usar una metaclase.

Solución
class Plugin:
def __init_subclass__(cls, **kwargs):
super().__init_subclass__(**kwargs)
if "nombre" not in cls.__dict__:
raise TypeError(f"{cls.__name__} debe definir 'nombre'")
class Limpiador(Plugin):
nombre = "limpiador"

El error salta al definir la clase, no al instanciarla, que es lo que se quiere: falla en el import, no en producción.

Obligaría a una metaclase si necesitaras inspeccionar o modificar el diccionario de nombres antes de que la clase exista (por ejemplo, para transformar anotaciones en campos), o si quisieras devolver una clase distinta de la declarada. Para validar y registrar, __init_subclass__ basta y se lee mucho mejor.

Comprobación con datos de ejemplo:

print(Limpiador.nombre)
try:
class Roto(Plugin):
pass
except TypeError as error:
print("error al definir:", error)
assert Limpiador.nombre == "limpiador", "la subclase valida define nombre"
  • Ramalho, L. Fluent Python, 2ª ed. Capítulo 24: Class Metaprogramming.
  • CPython 3.13: Objects/typeobject.c (type_new, type_call).
  • Mediciones: mediciones/04-05-08-descriptores-slots-metaclases.py.
  • 04 · ABCs y Protocol: ABCMeta es la metaclase más usada de la biblioteca.
  • 05 · Descriptores: la otra forma de interceptar el acceso.
  • 02 · Herencia, MRO: lo que la metaclase puede alterar al construir.