Defina un esquema para un modelo

Un Schema es una clase de Python que enumera los campos que deberían tener sus datos. Refleja un modelo, pero vive por separado y se ocupa únicamente de la entrada y la salida.

Cada esquema hereda de la clase base Schema de Marshmallow. Nombrarlo según su modelo, como UserSchema, deja clara la intención de un vistazo.

Dentro de la clase, añada atributos del módulo fields. Cada uno da nombre a una clave que aparecerá en la salida JSON serializada.

Elija un tipo de campo que coincida con los datos: Int, Str, Bool, Float o DateTime. El tipo controla cómo se formatean y validan los valores.

Un campo DateTime serializa automáticamente los datetimes de Python en cadenas ISO limpias. Ya no tendrá que repartir formatos manuales por sus vistas.

Pase required=True a un campo para que la carga falle si falta. Esta es su primera muestra de validación integrada directamente en el esquema.

Enumere únicamente los campos que quiera exponer. Al no declarar password_hash, el esquema nunca podrá filtrarlo en una respuesta.

¿Quiere obtener JSON en camelCase a partir de un atributo snake_case? Use data_key para asignar un nombre interno a una clave externa diferente.

Algunos campos, como un id, deberían aparecer en la salida, pero nunca aceptarse como entrada. Márquelos como dump_only para mantenerlos de solo lectura.

Cree una instancia para reutilizarla: user_schema es igual a UserSchema(). Más adelante, pase many=True al serializar una lista completa.

Esta misma clase volcará modelos a JSON y cargará JSON de nuevo como datos comprobados. Define la estructura una sola vez y la usa en ambas direcciones.

Una subclase de Schema declara campos tipados que se asignan a su modelo. Opciones como required, dump_only y data_key determinan exactamente qué entra y qué sale.