GuíaBásico

Guía de Tipado y Pydantic

Una anotación de tipo en Python es una etiqueta, no un candado: el intérprete la lee, la guarda y sigue ejecutando sin comprobar nada. Esta guía corrige ese malentendido de raíz y construye, sobre él, un sistema completo de tipado estático y validación en runtime con Pydantic v2. Trabajas sobre un solo caso de estudio realista —Cosecha, una plataforma que conecta productores agrícolas con restaurantes, donde todos los datos vienen de afuera (un CSV desordenado por productor, un webhook de pagos, una API de clima, un formulario web) y ninguno es confiable— y lo llevas de cuarenta funciones sin anotar a un sistema donde lo inválido no puede existir. Aprendes a instalar y leer un verificador de tipos (mypy) sin frustrarte con los primeros 300 errores, a describir la forma real de tus datos con el vocabulario completo de `typing`, a convertir esas descripciones en validación de verdad con Pydantic, a expresar reglas de negocio como código en vez de `if` dispersos, y a diseñar fronteras donde el dato se valida una sola vez para que el resto del sistema deje de programar a la defensiva. La guía cierra con los casos difíciles del mundo real —librerías sin tipos, JSON de forma variable, configuración por variables de entorno, migración de Pydantic v1 a v2— y con el criterio explícito para saber cuándo el tipado estorba y cuándo ceder con una razón escrita.