Definire uno schema per un model

Uno Schema è una classe Python che elenca i campi che devono avere i dati. Rispecchia un modello, ma vive separatamente ed è dedicato solo all'input e all'output.

Ogni schema eredita dalla classe di base Schema di Marshmallow. Chiamarlo come il modello, ad esempio UserSchema, rende immediata l'intenzione.

All'interno della classe aggiunga attributi dal modulo fields. Ognuno definisce una chiave che comparirà nell'output JSON serializzato.

Scelga un tipo di campo che corrisponda ai dati: Int, Str, Bool, Float o DateTime. Il tipo controlla la formattazione e la validazione dei valori.

Un campo DateTime serializza automaticamente i datetime Python in stringhe ISO ordinate. Non dovrà più distribuire la formattazione manuale nelle varie view.

Passi required=True a un campo, così il caricamento fallisce se il campo manca. Questo è il primo assaggio della validazione integrata direttamente nello schema.

Elenchi solo i campi che desidera esporre. Non dichiarando semplicemente password_hash, lo schema non potrà mai inserirlo in una risposta.

Desidera JSON in camelCase a partire da un attributo snake_case? Usi data_key per associare un nome interno a una chiave esterna diversa.

Alcuni campi, come un id, devono comparire nell'output ma non essere mai accettati come input. Li contrassegni con dump_only per mantenerli in sola lettura.

Crei un'unica istanza da riutilizzare: user_schema uguale a UserSchema(). Più avanti passi many=True quando serializza un elenco completo.

Questa singola classe convertirà i modelli in JSON e ricaricherà il JSON in dati verificati. Definisce la shape una sola volta e la usa in entrambe le direzioni.

Desidera che l'id sia leggibile nell'output, ma non venga mai accettato come input.

Una sottoclasse di Schema dichiara campi tipizzati associati al modello. Opzioni come required, dump_only e data_key definiscono esattamente ciò che entra e ciò che esce.