Descriptores
Un descriptor es un objeto que controla qué pasa cuando otro objeto accede a un atributo. property es un descriptor. Los métodos son descriptores. Los campos de un ORM son descriptores. Entender el protocolo convierte la expresión «magia de Python» en una regla de tres métodos.
En una línea
Sección titulada «En una línea»Si una clase tiene un atributo cuyo valor es un objeto con __get__, ese objeto decide qué devuelve instancia.atributo.
El protocolo
Sección titulada «El protocolo»class Validador: def __set_name__(self, dueño, nombre): self.nombre = nombre
def __get__(self, instancia, dueño=None): if instancia is None: return self # acceso desde la clase return instancia.__dict__[self.nombre]
def __set__(self, instancia, valor): if valor < 0: raise ValueError(f"{self.nombre} no puede ser negativo") instancia.__dict__[self.nombre] = valorTres métodos, tres momentos:
| Método | Cuándo se llama |
|---|---|
__set_name__ |
Al definir la clase, una sola vez |
__get__ |
Cada lectura del atributo |
__set__ |
Cada escritura |
Data descriptor y no-data descriptor
Sección titulada «Data descriptor y no-data descriptor»La diferencia decide quién gana cuando hay un valor en instancia.__dict__:
- Data descriptor: define
__set__o__delete__. Gana siempre frente al diccionario de instancia. - No-data descriptor: sólo define
__get__. Pierde si el diccionario tiene una entrada con ese nombre.
Por eso un método (no-data) se puede sobrescribir con instancia.metodo = algo, y una property (data) no.
| Forma | Coste por lectura |
|---|---|
| Atributo plano | 34 ns |
@property |
51 ns (1.5×) |
Descriptor propio con __get__ |
90 ns (2.6×) |
python mediciones/04-05-08-descriptores-slots-metaclases.py
Cada capa cuesta una llamada a Python. property está implementada en C y por eso es más barata que un descriptor escrito a mano.
El caso que justifica todo: validación reutilizable
Sección titulada «El caso que justifica todo: validación reutilizable»class Positivo(Validador): def __set__(self, instancia, valor): if valor <= 0: raise ValueError("debe ser positivo") instancia.__dict__[self.nombre] = valor
class Producto: precio = Positivo() stock = Positivo()Una clase, dos campos validados, cero repetición. Con property habría que escribir dos getters y dos setters; con descriptores, se escribe una vez la regla y se reutiliza.
Ese es el patrón que usan los ORM: cada campo es un descriptor que sabe leer de la base de datos y convertir el tipo.
La trampa
Sección titulada «La trampa»Cuándo NO escribir un descriptor
Sección titulada «Cuándo NO escribir un descriptor»- Para un solo campo. Un
propertyo incluso unifen el setter se lee mejor. - Si el objeto es inmutable, no hay setter que controlar.
- Si la validación es de la clase entera (
__post_init__de una dataclass), un descriptor por campo la fragmenta. - Para calcular algo caro en cada lectura. Eso es
cached_property(capítulo 04 de la Parte III).
Ejercicio
Sección titulada «Ejercicio»Implementa un descriptor Rango(minimo, maximo) que valide en escritura y funcione en dos clases distintas. Después explica qué pasaría si dos clases compartieran la misma instancia del descriptor.
Solución
class Rango: def __init__(self, minimo, maximo): self.minimo, self.maximo = minimo, maximo
def __set_name__(self, dueño, nombre): self.nombre = nombre
def __get__(self, instancia, dueño=None): if instancia is None: return self return instancia.__dict__[self.nombre]
def __set__(self, instancia, valor): if not self.minimo <= valor <= self.maximo: raise ValueError(f"{self.nombre} fuera de rango") instancia.__dict__[self.nombre] = valor
class Sensor: temperatura = Rango(-40, 85)
class Motor: rpm = Rango(0, 6000)Cada clase crea su propia instancia de Rango, así que cada una tiene su nombre y sus límites.
Si compartieran la misma:
compartido = Rango(0, 100)class A: campo = compartidoclass B: campo = compartido__set_name__ se ejecuta al definir A (nombre campo) y otra vez al definir B (nombre campo), así que en este caso coinciden y no se nota. El problema aparece con nombres distintos: la segunda definición sobrescribe self.nombre y la primera clase empieza a leer y escribir en el atributo de la otra. Un descriptor por atributo, nunca compartido entre nombres distintos.
Referencias
Sección titulada «Referencias»- Ramalho, L. Fluent Python, 2ª ed. Capítulo 23: Attribute Descriptors.
- CPython 3.13:
Objects/descrobject.c,Objects/funcobject.c(func_descr_get). - Mediciones:
mediciones/04-05-08-descriptores-slots-metaclases.py.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 06 · Atributos y
__slots__: dónde se guarda el valor que el descriptor lee. - 03 · Composición: los descriptores son delegación a nivel de atributo.
- 07 · Metaclases: quién ejecuta
__set_name__.