Formations — 1 037 leçons en français

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.dumps fait 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 pour loads (depuis une chaîne) et load (depuis un fichier).

ensure_ascii

Option de json.dumps, à True par défaut : les caractères non ASCII sont échappés (\u00e9 au lieu de é). Le résultat reste valide, mais illisible. Mettez ensure_ascii=False quand vous écrivez de l'UTF-8.

default (fonction de secours)

Fonction passée à json.dumps et appelée pour chaque objet que le module ne sait pas convertir. Elle doit renvoyer quelque chose de sérialisable, ou relever TypeError. C'est le point d'entrée propre pour les datetime, les Decimal ou vos dataclasses.

JSONDecodeError

Exception levée quand le texte lu n'est pas du JSON valide. Elle hérite de ValueError et porte les attributs msg, pos, lineno et colno, 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.

Lire l'explication détaillée et faire le quiz →

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.