Lección 22 de 47 · De clases a clases✦ WebMCP implementado
@dataclass frente al constructor promovido
10 min de lectura4 retos
En la lección anterior escribiste __init__, __repr__ y __eq__ a mano para una clase que solo guarda datos. Es muchísimo código repetido. El decorador @dataclass los escribe por ti: es lo más parecido al constructor promovido y al readonly de PHP 8.5. Con él nace la Tarea definitiva de nuestra app.
¿De dónde vienen los nombres?
dataclass = inglés data class (clase de datos)
Una clase cuyo trabajo principal es guardar datos. El decorador le fabrica el __init__, el __repr__ y el __eq__.
field = inglés field (campo)
Función para dar opciones a un campo concreto: su valor por defecto, si entra en la comparación, etc.
Una función que fabrica el valor por defecto cada vez que se crea un objeto. Así cada tarea recibe su propia lista.
frozen = inglés frozen (congelado)
Un objeto congelado no admite cambios después de crearse. Es el readonly de PHP.
slots = inglés slot (hueco, ranura)
Reserva un hueco fijo por cada campo, en vez de un diccionario por objeto: ocupa menos memoria y no deja inventar atributos.
En 4 ideas
1/4
@dataclass + campos con tipo (titulo: str) generan __init__, __repr__ y __eq__. Es el constructor promovido de PHP (public function __construct(public string $titulo)), pero sin escribir el constructor.
El valor por defecto de un campo mutable (lista, dict, set) va con field(default_factory=list); etiquetas: list[str] = [] da ValueError. En PHP cada objeto copia su array, y aquí hay que pedirlo.
@dataclass(frozen=True) congela el objeto: asignar un campo lanza FrozenInstanceError. Es el readonly de PHP 8.5, y para «cambiar» una tarea se crea otra con dataclasses.replace(...) (el with de PHP).
@dataclass(order=True) añade <, >, <=, >= comparando campo a campo, slots=True ahorra memoria y __post_init__ valida justo después del __init__.
1 · De la clase a mano a @dataclass
Mira la Tarea de la lección anterior, para guardar solo tres datos. Y ahora la misma con @dataclass. Las dos hacen exactamente lo mismo:
Los campos son las líneas nombre: tipo del cuerpo de la clase. En un @dataclass el tipo no es opcional: es lo que le dice qué campos hay (y en qué orden).
Los campos con valor (hecha: bool = False) van después de los que no lo tienen, igual que los parámetros con valor por defecto en una función.
Python no comprueba el tipo al ejecutar: Tarea("uno", 2) funciona. Los tipos son para ti, el editor y herramientas como mypy.
La clase sigue siendo una clase normal: puedes añadirle métodos (completar, __str__…) como siempre.
¿Por qué? · En PHP no existe
¿Por qué @dataclass y no un constructor promovido como en PHP?
Python no tiene propiedades declaradas en la clase: los atributos nacen al asignarlos, como viste. Para el caso, tan común, de «una clase solo para guardar datos» se creó este decorador, que genera código a partir de las anotaciones de tipo.
El resultado es el mismo ahorro que el constructor promovido de PHP 8, con una ventaja: también te regala __repr__ y __eq__ correctos. Antes tenías que escribirlos tú o aceptar el <Tarea object at 0x...> inútil.
2 · Valores por defecto y la trampa de la lista
Nuestra Tarea del dominio tiene una lista de etiquetas. Aquí está la trampa que ya conoces, pero con una diferencia: @dataclass te avisa, porque sabe lo peligroso que es:
Pythonmain.py
from dataclasses import dataclass
try:
@dataclassclassTarea:
id: int
titulo: str
etiquetas: list[str] = []
exceptValueErroras error:
print("ValueError:", error)
La solución es field(default_factory=list): en vez de un valor, le das una función que fabrica uno nuevo para cada objeto.
Pythonmain.py
from dataclasses import dataclass, field
@dataclassclassTarea:
id: int
titulo: str
hecha: bool = False
etiquetas: list[str] = field(default_factory=list)
a = Tarea(1, "Comprar pan")
b = Tarea(2, "Llamar al banco")
a.etiquetas.append("casa")
print(a.etiquetas, b.etiquetas)
print(a.etiquetas is b.etiquetas)
from dataclasses import dataclass, field
@dataclassclassTarea:
id: int
titulo: str
etiquetas: list[str] = field(default_factory=list)
a = Tarea(1, "Comprar pan")
b = Tarea(2, "Llamar al banco")
a.etiquetas.append("casa")
print(a.etiquetas, b.etiquetas)
¿Por qué? · En PHP no existe
¿Por qué hace falta default_factory? En PHP basta con = []
En PHP, array $etiquetas = [] es seguro: los arrays se copian al asignar, así que cada tarea tiene el suyo. En Python una lista no se copia: es un objeto que se comparte, y el valor por defecto se evalúa una sola vez, al definir la clase (la misma trampa del [] por defecto de mutable frente a inmutable).
@dataclass rechaza list, dict y set como valor por defecto para que no cometas el error. Con default_factory=list Python llama a list() en cada objeto nuevo, y cada tarea recibe la suya.
3 · frozen=True: el readonly de PHP
Por defecto una dataclass se puede cambiar (tarea.hecha = True). Si quieres un objeto de solo lectura, como una clase readonly de PHP 8.5, pon frozen=True. Para «cambiar» una tarea congelada creas una copia con el campo nuevo, con replace:
Pythonmain.py
from dataclasses import dataclass, replace
@dataclass(frozen=True)
classTarea:
id: int
titulo: str
hecha: bool = False
tarea = Tarea(1, "Comprar pan")
try:
tarea.hecha = TrueexceptExceptionas error:
print(type(error).__name__ + ":", error)
hecha = replace(tarea, hecha=True)
print(tarea)
print(hecha)
print(tarea is hecha)
# Un objeto congelado se puede meter en un set o usar de clave de un dict.print(len({tarea, hecha, Tarea(1, "Comprar pan")}))
¿Por qué congelar un objeto? En PHP no era obligatorio
En el módulo anterior viste que los objetos de Python se comparten: si una función recibe una tarea y la cambia, todos los que la tienen ven el cambio. Un objeto congelado te quita ese susto: si te lo pasan, sabes que no cambiará por debajo.
Además, un frozen=True con eq=True (el valor por defecto) es hashable: puede ir dentro de un set o ser clave de un dict. Una dataclass normal con eq=True no lo es, por lo que viste con __eq__ sin __hash__.
4 · order=True, slots=True y __post_init__
Tres opciones más del decorador, y un método especial para validar:
order=True: genera <, <=, > y >= comparando los campos en el orden en que están escritos, como compara PHP dos arrays (<=>). Con eso sorted(...) y max(...) funcionan solos.
slots=True: guarda los datos en huecos fijos, no en un diccionario por objeto. Ocupa menos memoria y evita que inventes atributos (tarea.titullo = ... da error, justo la errata que PHP deja pasar).
__post_init__: método que Python llama justo después del __init__ generado. Sirve para validar o normalizar los datos.
Pythonmain.py
from dataclasses import dataclass
@dataclass(order=True, slots=True)
classTarea:
prioridad: int
titulo: strdef__post_init__(self):
self.titulo = self.titulo.strip()
ifnotself.titulo:
raiseValueError("El título no puede estar vacío")
tareas = [Tarea(2, "Llamar al banco"), Tarea(3, " Comprar pan "), Tarea(2, "Barrer")]
print(max(tareas))
print([t.titulo for t insorted(tareas)])
try:
Tarea(1, " ")
exceptValueErroras error:
print("ValueError:", error)
try:
tareas[0].titullo = "oops"exceptAttributeError:
print("AttributeError: con slots no se inventan atributos")
5 · Equivalencia POO: PHP frente a Python
Equivalencia POO · PHP → Python
La clase de datos de PHP 8.5 y su equivalente en Python, opción a opción.
PHP
Python
Quién lo ve
__construct(public int $id, public string $titulo) (constructor promovido)
Convierte la clase Tarea en una @dataclass con los campos id: int, titulo: str y hecha: bool = False, sin escribir __init__ ni __repr__. print(Tarea(1, "Comprar pan")) debe mostrar Tarea(id=1, titulo='Comprar pan', hecha=False). Es el constructor promovido de PHP.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista. Pon @dataclass encima de class Tarea: y crea la tarea con Tarea(1, "Comprar pan").
Reto 2 de 4 · ✓ Resuelto
Cada tarea, sus etiquetas
Escribe la dataclass Tarea con id: int, titulo: str y etiquetas: list[str], de modo que Tarea(1, "a") tenga etiquetas == [] y cada tarea tenga su propia lista. etiquetas = [] daría ValueError: usa field(default_factory=list).
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista.etiquetas: list[str] = field(default_factory=list). Pasas la función listsin paréntesis.
Reto 3 de 4 · ✓ Resuelto
Completar sin tocar
La dataclass Tarea ya es de solo lectura (frozen=True). Escribe la función completar(tarea) que devuelva una tarea nueva igual pero con hecha=True, usando dataclasses.replace; la original no debe cambiar. En PHP sería un método completar() con new self(...) en una clase readonly.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista.replace(tarea, hecha=True) devuelve una copia con ese campo cambiado.
Reto 4 de 4 · ✓ Resuelto
Una tarea que se valida sola
Completa __post_init__ de Tarea: debe quitar los espacios de los extremos del título y lanzar ValueError si después el título queda vacío. Tarea(1, " Comprar pan ").titulo debe ser "Comprar pan". Es la validación que en PHP harías en el cuerpo del constructor.
Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.
Pythonmain.py · editable
Pista. Reasigna self.titulo = self.titulo.strip() y, si not self.titulo, raise ValueError(...).
Resumen
Lo que te llevas de esta lección
@dataclass genera __init__, __repr__ y __eq__ a partir de campo: tipo (en PHP, el constructor promovido).
Listas, diccionarios y sets por defecto van con field(default_factory=list); = [] da ValueError (en PHP, = [] es seguro porque el array se copia).
frozen=True hace el objeto de solo lectura y hashable (el readonly de PHP 8.5); replace() crea una copia con un campo cambiado.
order=True compara campo a campo, en el orden escrito; el primero manda.
slots=True ahorra memoria y caza las erratas en los nombres de atributos.
__post_init__ valida o normaliza justo después del __init__ (en PHP, el cuerpo del constructor).
Para recordarlo: «Fábrica, Hielo y Orden»
FFábrica field(default_factory=list) para lo mutable
HHielo frozen=True: congelado, como readonly
OOrden order=True: el primer campo manda
Si el campo es una lista, fábrica; si no debe cambiar, hielo; si hay que ordenar, orden.