dataclasses, enum y contextlib

dataclasses reduce el código repetitivo para objetos de datos. enum proporciona constantes con nombre con seguridad de tipos. contextlib simplifica los gestores de contexto (contextmanager, suppress, ExitStack).

Receta

from dataclasses import dataclass
from enum import StrEnum
from contextlib import contextmanager
 
class Status(StrEnum):
    PENDING = "pending"
    DONE = "done"
 
@dataclass(frozen=True)
class Job:
    id: int
    status: Status = Status.PENDING

Cuándo usar esto:

• DTOs y registros de configuración -> dataclass
• Constantes de modo/estado -> StrEnum
• Ámbitos rápidos de recursos -> @contextmanager
• Archivo opcional ausente -> suppress(FileNotFoundError)
• Muchos gestores anidados -> ExitStack

Ejemplo de funcionamiento

from contextlib import contextmanager, suppress
from dataclasses import dataclass, field
from enum import StrEnum
 
class Role(StrEnum):
    ADMIN = "admin"
    USER = "user"
 
@dataclass
class Account:
    email: str
    role: Role = Role.USER
    tags: list[str] = field(default_factory=list)
 
@contextmanager
def temp_role(account: Account, role: Role):
    old = account.role
    account.role = role
    try:
        yield account
    finally:
        account.role = old
 
ada = Account("ada@example.com")
with temp_role(ada, Role.ADMIN):
    print("elevated", ada.role)
print("restored", ada.role)
 
with suppress(FileNotFoundError):
    open("missing.cfg").read()

Lo que esto demuestra:

• frozen=True para objetos de valor inmutables
• field(default_factory=list) evita el error común de valores predeterminados mutables
• StrEnum se serializa limpiamente a cadenas JSON
• contextmanager para estados temporales reversibles

Inmersión Profunda

Opciones de dataclass

• slots=True (3.10+) ahorra memoria
• kw_only=True (3.10+) construcción explícita
• __post_init__ para validación

Sabores de enum

• StrEnum para APIs JSON
• IntEnum para códigos numéricos
• Decorador @unique para evitar duplicados de alias

Errores comunes

• dataclass mutable como clave de diccionario - no se puede hashear a menos que sea frozen. Solución: frozen=True o no usar la instancia como clave.
• Comparación de enum con cadena sin formato - StrEnum compara igual con str en 3.11+, pero sé explícito en las APIs. Solución: usar Role como tipo de dato, no str.
• contextmanager sin try/finally - la limpieza se omite en caso de error. Solución: envolver yield en try/finally.
• ExitStack olvidado - errores de cierre manual. Solución: usar siempre with ExitStack().
• dataclass vs Pydantic - dataclass no tiene validación. Solución: Pydantic en el límite HTTP.

Alternativas

Preguntas frecuentes

Relacionado

• Context Managers as a Pattern - profundidad del patrón
• json & Serialization - StrEnum en JSON
• collections recap - Counter con enums
• Standard Library Best Practices - reglas ergonómicas

Versiones de la pila: Esta página se escribió para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.