json

Convertit des données Python en texte JSON et inversement. La base de l’enregistrement de données et de la communication avec les API.

Renvoie
dumps() renvoie une chaîne, et loads() un objet Python, le plus souvent un dict ou une list.
Sur cette page

Exemple

#
Python
import json

student = {
    "name": "Léa",
    "points": 1240,
    "courses": ["HTML", "Python"],
    "premium": False,
    "mentor": None,
}

text = json.dumps(student)
print(text)

data = json.loads('{"level": 3, "badges": ["start", "serie_7"]}')
print(data["badges"][1], type(data).__name__)
Résultatrésultat enregistré, vous pouvez le vérifier
{"name": "L\u00e9a", "points": 1240, "courses": ["HTML", "Python"], "premium": false, "mentor": null}
serie_7 dict

Définition et utilisation

#

Le module json convertit les dictionnaires, listes, chaînes, nombres, booléens et None en texte au format JSON, et relit aussi ce texte en objets Python. JSON est le format d’échange de données le plus répandu entre applications, API et fichiers de configuration.

Les fonctions se terminant par la lettre « s » travaillent sur des chaînes : dumps() crée le texte et loads() le lit. Les versions sans « s », c’est-à-dire dump() et load(), écrivent dans un fichier et lisent depuis un fichier. Lors de la conversion, True devient true, None devient null et les tuples se transforment en listes.

Par défaut, les caractères non ASCII, comme les lettres accentuées, sont écrits sous forme de séquences du type \u00fc. L’argument ensure_ascii=False les conserve sous une forme lisible, et indent=2 répartit le résultat sur plusieurs lignes indentées. Un texte invalide lève l’exception json.JSONDecodeError.

Syntaxe

#
Syntaxe
import json

json.dumps(obj, indent=None, ensure_ascii=True, sort_keys=False)
json.loads(texte)
json.dump(obj, fichier)
json.load(fichier)

Paramètres

#
  • obj

    dict, list, str, int, float, bool, None

    Les données à écrire avec dumps() ou dump().
  • indent

    int, facultatif

    Le nombre d’espaces d’indentation. Sans lui, tout le JSON tient sur une seule ligne.
  • ensure_ascii

    bool, True par défaut

    Mettez False pour que les caractères non ASCII soient écrits tels quels, et non sous la forme \u….
  • sort_keys

    bool, False par défaut

    Trie les clés des dictionnaires par ordre alphabétique.
  • default

    fonction, facultative

    Appelée pour les objets que JSON ne prend pas en charge. default=str écrira par exemple les dates sous forme de texte.

Plus d’exemples

#
Caractères non ASCII et indentation
Python
import json

city = {"city": "Zürich", "students": 120}

print(json.dumps(city))
print(json.dumps(city, ensure_ascii=False, indent=2))
Résultatrésultat enregistré, vous pouvez le vérifier
{"city": "Z\u00fcrich", "students": 120}
{
"city": "Zürich",
"students": 120
}
Écrire et lire un fichier JSON
Python
import json

progress = {"student": "Léa", "done": ["1_1", "1_2"], "streak": 5}

with open("progres.json", "w", encoding="utf-8") as file:
    json.dump(progress, file, ensure_ascii=False, indent=2)

with open("progres.json", encoding="utf-8") as file:
    loaded = json.load(file)

print(loaded["done"])
print(loaded == progress)
Résultatrésultat enregistré, vous pouvez le vérifier
['1_1', '1_2']
True

Bonnes pratiques

#
  • JSON exige des guillemets doubles autour des clés et des chaînes. Un texte copié depuis print(dictionnaire), avec des guillemets simples, n’est pas du JSON valide.
  • Les clés en JSON sont toujours des chaînes : le dictionnaire {1: "a"} aura la clé "1" après écriture et lecture.
  • Vous pouvez écrire des dates et des objets personnalisés en passant default=str ou en les convertissant d’abord en dictionnaires.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.