Accueil › Python › JSON : sérialiser sans perdre ses types
JSON : sérialiser sans perdre ses types
Données, JSON et APIavance
Le module json fait la traduction entre les objets Python et le format texte que parlent toutes les API.
import json
commande = {"id": 42, "client": "Amélie", "total": 19.9, "payee": False}
texte = json.dumps(commande, ensure_ascii=False)
# '{"id": 42, "client": "Amélie", "total": 19.9, "payee": false}'
retour = json.loads(texte) # dict Python
Quatre fonctions, et la seule différence est la source : dumps/loads travaillent sur une chaîne, dump/load sur un fichier ouvert.
with open("commandes.json", "w", encoding="utf-8") as f:
json.dump(commande, f, ensure_ascii=False, indent=2)
Le point à retenir avant tout le reste : JSON connaît six types — objet, tableau, chaîne, nombre, booléen, null. Tout ce que Python a en plus doit être traduit, et la traduction n'est pas réversible.
| Python | JSON | Au retour de loads |
|---|---|---|
dict |
objet | dict |
list, tuple |
tableau | list |
str |
chaîne | str |
int, float |
nombre | int, float |
True / False |
true / false |
bool |
None |
null |
None |
set, datetime, Decimal |
rien | TypeError |
Un tuple part et revient en liste. Une clé entière part et revient en chaîne. Un set ne part pas du tout.
Les termes à connaître
- Sérialiser
Transformer un objet Python en une suite de caractères (ou d'octets) qu'on peut écrire dans un fichier ou envoyer sur le réseau.
json.dumpsfait ce travail. L'opération inverse — reconstruire un objet à partir du texte — s'appelle désérialiser (json.loads).- json.dumps / json.dump
dumps(avec un s pour string) renvoie une chaîne.dumpécrit directement dans un fichier ouvert. Même chose pourloads(depuis une chaîne) etload(depuis un fichier).- ensure_ascii
Option de
json.dumps, àTruepar défaut : les caractères non ASCII sont échappés (\u00e9au lieu deé). Le résultat reste valide, mais illisible. Mettezensure_ascii=Falsequand vous écrivez de l'UTF-8.- default (fonction de secours)
Fonction passée à
json.dumpset appelée pour chaque objet que le module ne sait pas convertir. Elle doit renvoyer quelque chose de sérialisable, ou releverTypeError. C'est le point d'entrée propre pour lesdatetime, lesDecimalou vos dataclasses.- JSONDecodeError
Exception levée quand le texte lu n'est pas du JSON valide. Elle hérite de
ValueErroret porte les attributsmsg,pos,linenoetcolno, qui indiquent où la lecture a échoué.- Aller-retour (round-trip)
Sérialiser puis désérialiser. En JSON, l'aller-retour n'est pas neutre : certains types Python en reviennent transformés en un autre type.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.