JSON vers Python
Générez des classes Python à partir d’un exemple JSON, sous forme de modèles Pydantic ou de dataclasses de la bibliothèque standard. Les objets imbriqués deviennent leurs propres classes, déclarées avant leur utilisation. Les champs facultatifs et nullables utilisent Optional avec une valeur par défaut None lorsque la clé peut manquer, et les valeurs de types mixtes utilisent Union. Les noms des champs passent en snake_case.
Foire aux questions
Comment les objets imbriqués sont-ils nommés ?
Chaque objet imbriqué devient son propre type Python, nommé d’après la clé qui le contient en PascalCase : address devient donc Address. Les objets dans des tableaux prennent la forme singulière de la clé du tableau : users devient ainsi User. Les objets ayant exactement les mêmes champs partagent un type.
Quand un champ est-il facultatif ?
Lorsqu’un tableau contient plusieurs objets et qu’une clé est absente de certains d’entre eux, le champ correspondant est facultatif : son type est enveloppé dans Optional et sa valeur par défaut est None. Une clé présente dans chaque exemple est obligatoire. Un objet unique ne permet aucune comparaison ; toutes ses clés sont donc obligatoires.
Comment les valeurs null sont-elles traitées ?
Une clé qui vaut null dans certains exemples et contient une valeur dans d’autres devient Optional du type correspondant. Une clé toujours égale à null ne donne aucune indication sur son type réel ; elle devient donc Optional[Any]. Collez un exemple contenant une valeur réelle pour obtenir un type précis.
Quels types sont utilisés pour les nombres ?
Les nombres entiers deviennent int et les nombres décimaux deviennent float. Un champ qui contient les deux devient float.
Que deviennent les clés qui ne sont pas des noms valides ?
Les noms des champs sont convertis en snake_case. Les modèles Pydantic conservent la clé d’origine avec Field(alias=...) ; model_validate lit ainsi le JSON tel quel. Les dataclasses ne prennent pas en charge les alias : renommez donc vous-même les clés avant de créer une dataclass à partir de JSON dont les clés ne sont pas des noms Python valides. Les mots-clés Python, comme class, reçoivent un trait de soulignement final.
Mon JSON est-il téléversé ou stocké ?
Le JSON est envoyé au serveur uniquement pour générer le code correspondant à cette requête et n’est pas stocké. Le générateur ne lit que la structure et les types de valeurs de votre exemple. Vous pouvez donc remplacer les valeurs sensibles par des espaces réservés du même type avant de le coller.