Saltearse al contenido

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.

Si una clase tiene un atributo cuyo valor es un objeto con __get__, ese objeto decide qué devuelve instancia.atributo.

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] = valor

Tres 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

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.

Leer el mismo atributo un millón de veces
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.

  • Para un solo campo. Un property o incluso un if en 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).

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 = compartido
class 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.

  • 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.
  • 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__.