¿Qué ventaja práctica aporta `@dataclass` en modelos de datos?

Dataclass genera automáticamente partes repetitivas y deja el modelo más claro para mantenimiento.

Dataclasses y tipado en Python: modelos claros y mantenibles

Aprende a usar `@dataclass` y type hints para definir modelos de dominio legibles, con menos boilerplate y mejor soporte de herramientas.

¿Cuánto sabes de Python?

📘 Teoría

1) Qué resuelve `@dataclass`

Cuando una clase representa principalmente datos, dataclass ahorra boilerplate sin perder claridad.

Sin dataclass, escribir `__init__`, `__repr__` y comparaciones manualmente añade ruido y aumenta riesgo de inconsistencias.

Con `@dataclass`, declaras campos y Python genera partes repetitivas automáticamente.

Esto acelera desarrollo y mejora legibilidad en modelos DTO/entidades sencillas.

Dataclass básica

from dataclasses import dataclass


@dataclass
class Producto:
    nombre: str
    precio: float
    stock: int = 0


print(Producto('Teclado', 39.9, 12))

2) Tipado como contrato técnico

Los type hints no cambian runtime por sí solos, pero mejoran calidad de desarrollo y mantenimiento.

Anotar `list[str]`, `dict[str, int]`, `Optional[str]` o `Literal[...]` documenta expectativas de entrada/salida.

Herramientas como Pyright o MyPy aprovechan estas anotaciones para detectar incompatibilidades antes de ejecutar.

En equipos, el tipado reduce ambigüedad al integrar módulos distintos.

Función tipada

Firma explícita de contrato.

Dataclass tipada

Campos con tipos claros.

3) Validación con `__post_init__`

Usa `__post_init__` para imponer invariantes tras construcción.

`__post_init__` se ejecuta después del constructor generado por dataclass.

Es ideal para validar reglas como precios positivos, emails válidos o estados permitidos.

Así mantienes objetos consistentes desde su creación.

Dataclass para modelos centrados en datos.
Tipado para contratos explícitos.
`__post_init__` para reglas de dominio.
Evita clases anémicas sin comportamiento útil.

Invariante de precio

from dataclasses import dataclass


@dataclass
class Item:
    nombre: str
    precio: float

    def __post_init__(self) -> None:
        if self.precio < 0:
            raise ValueError('precio no puede ser negativo')

1 1) Qué resuelve `@dataclass` 2 2) Tipado como contrato técnico 3 3) Validación con `__post_init__`