JSON : sérialisation et parsing

JSON est le format d'échange de données le plus répandu. Le module json de la bibliothèque standard le gère nativement.

De Python à JSON : dumps

json.dumps(object) sérialise un objet Python en une chaîne JSON.

import json

dati = {"nome": "Ada", "anni": 36, "skills": ["python", "matematica"]}
json.dumps(dati)
# '{"nome": "Ada", "anni": 36, "skills": ["python", "matematica"]}'

json.dumps(dati, indent=2, sort_keys=True)
# multi-line formatted string, keys sorted

De JSON à Python : loads

json.loads(string) analyse une chaîne JSON et renvoie des objets Python.

testo = '{"nome": "Ada", "anni": 36}'
d = json.loads(testo)
d["nome"]    # 'Ada'
type(d)      # <class 'dict'>

Correspondance des types (mapping)

Depuis un fichier : dump / load

with open("config.json", "w") as f:
    json.dump(dati, f, indent=2)

with open("config.json") as f:
    dati = json.load(f)

Sans le « s » final, ils fonctionnent sur des fichiers (file-like) ; avec le « s », sur des chaînes de caractères.

Types non sérialisables : default

datetime, set, vos classes personnalisées ne sont pas sérialisables par défaut :

import datetime, json
json.dumps({"ora": datetime.datetime.now()})
# TypeError: Object of type datetime is not JSON serializable

Vous pouvez passer une fonction default qui explique comment les transformer :

def converti(obj):
    if isinstance(obj, datetime.datetime):
        return obj.isoformat()
    if isinstance(obj, set):
        return list(obj)
    raise TypeError(f"non serializzabile: {type(obj)}")

json.dumps({"ora": datetime.datetime.now()}, default=converti)

JSON et opérations sur les fichiers

La bibliothèque standard fournit également json.dump() et json.load() (sans le 's') pour écrire et lire des données JSON directement dans et depuis des fichiers, s'associant naturellement avec les gestionnaires de contexte :

with open("data.json", "w") as f:
    json.dump(data, f)

À vous de jouer

Exercice de révision

Défi supplémentaire