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, etloads()un objet Python, le plus souvent undictou unelist.
Exemple
#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__)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
#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 avecdumps()oudump().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
MettezFalsepour 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
#import json
city = {"city": "Zürich", "students": 120}
print(json.dumps(city))
print(json.dumps(city, ensure_ascii=False, indent=2))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)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=strou en les convertissant d’abord en dictionnaires.
Entrées associées
#- dict()Crée un dictionnaire à partir de paires clé-valeur ou d’arguments nommés.
- open()Ouvre un fichier en lecture ou en écriture et renvoie un objet fichier.
- withUn gestionnaire de contexte : préparation et nettoyage automatiques des ressources.
- datetimeDates et heures : création, formatage, lecture depuis du texte et calculs sur des intervalles de temps.
- pathlibLes chemins comme objets : assemblage avec l’opérateur /, lecture des parties d’un chemin et travail sur les fichiers.
- csvLecture et écriture de fichiers CSV, c’est-à-dire des tableaux enregistrés sous forme de texte, dont les valeurs sont séparées par une virgule ou un point-virgule.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.