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: el 90 % de lo que se hace con metaclases se hace hoy con __init_subclass__ y menos código.
En una línea
Sección titulada «En una línea»Las clases también son objetos, y una metaclase es la que los construye.
type como fábrica
Sección titulada «type como fábrica»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.
La metaclase
Sección titulada «La metaclase»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__: el 90 %
Sección titulada «__init_subclass__: el 90 %»class Modelo: registro = {}
def __init_subclass__(cls, **kwargs): super().__init_subclass__(**kwargs) Modelo.registro[cls.__name__] = clsSin 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.
| 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.
Cuál elegir
Sección titulada «Cuál elegir»| 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) |
La trampa
Sección titulada «La trampa»Cuándo NO usar metaclases
Sección titulada «Cuándo NO usar metaclases»- 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.
Ejercicio
Sección titulada «Ejercicio»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.
Referencias
Sección titulada «Referencias»- 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.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 04 · ABCs y Protocol:
ABCMetaes 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.