Bases de Python

Lire et écrire du JSON en Python

Dans cette leçon, vous allez convertir une chaîne JSON en dictionnaire Python et inversement avec le module json intégré.

  • Débutant
  • 2 min de lecture
  • 1 exemple exécutable

Introduction

Le problème

Les programmes échangent sans cesse des données : une API web envoie un utilisateur, un fichier de réglages stocke des options, un autre programme attend vos résultats. Il leur faut un format texte commun que les deux côtés comprennent. JSON est ce format, et Python doit le transformer en dictionnaires et en listes, et inversement.

Imaginez-le ainsi

JSON, c'est comme un formulaire rempli selon un modèle standard que toutes les administrations savent lire. json.loads lit le formulaire et le transforme en données Python avec lesquelles vous pouvez travailler. json.dumps réécrit vos données Python selon le même modèle, pour que n'importe quel autre programme puisse les lire.

D'un formulaire standard au code
json.loads(...)📥 Lire le formulaire et en faire des données Python
user["score"] = 95🖊️ Ajouter un champ
json.dumps(user, indent=2)📤 Le réécrire selon le modèle standard
true🔤 Le true de JSON devient le True de Python
Du texte JSON en entrée, des valeurs Python pour travailler, du texte JSON en sortie.
En une phrase

JSON est un format texte pour les données ; le module json convertit du texte JSON en valeurs Python (json.loads) et des valeurs Python en texte JSON (json.dumps).

Points clés

  1. json.loads(...) transforme le texte JSON en dictionnaire Python, le true de JSON devenant True.
  2. user["score"] = 95 modifie les données comme n'importe quel dictionnaire.
  3. json.dumps(user, indent=2) les réécrit en texte JSON, indenté pour être lisible.
  4. Dans la sortie, le True de Python redevient le true de JSON.

Quand l’utiliser ?

  • Lire les réponses des API web et leur envoyer des données.
  • Enregistrer des réglages ou de petits jeux de données dans un fichier lisible.
  • Transmettre des données entre programmes écrits dans des langages différents.

Quand s'en passer

  • Les dates, les sets ou vos propres classes : JSON ne peut pas les stocker directement, convertissez-les d'abord en chaînes ou en dictionnaires.
  • Les énormes tableaux de nombres : un fichier CSV ou une base de données est plus compact et plus rapide.

Code d’exemple

Exécuter le code →
main.py
import json

user = json.loads('{"name": "Ada", "active": true}')
user["score"] = 95

print(json.dumps(user, indent=2))
Obtenir un bouton Run pour cet exemple

Résultat de l’exécution

{
  "name": "Ada",
  "active": true,
  "score": 95
}

Explication du code

La fonction json.loads() lit une chaîne JSON et renvoie un dictionnaire, dans lequel la valeur true du JSON devient le True de Python. Après l'ajout de la clé score, la fonction json.dumps() reconvertit le dictionnaire en chaîne JSON. Le paramètre indent=2 indente le résultat pour le rendre plus lisible.

Modifiez les valeurs et exécutez le programme avec le compilateur Python en ligne CodeUtility, sans installation locale.

Exercices d’approfondissement

Essayez de modifier le code en suivant les pistes ci-dessous. Changer le code et observer le résultat vous fera bien mieux comprendre la leçon que la simple lecture.

  1. Changez les données d’entrée et prévoyez le résultat avant d’exécuter.
  2. Ajoutez une vérification pour les données vides ou invalides.
  3. Placez le traitement dans une fonction séparée et testez-la avec plusieurs jeux de données.
Exécuter dans le compilateur Python →

Erreurs fréquentes

Confondre loads et load

loads lit une chaîne, load lit depuis un fichier ouvert. Le s veut dire string.

Problème
with open("user.json") as f:
    user = json.loads(f)
Correction
with open("user.json") as f:
    user = json.load(f)

Écrire du JSON avec des apostrophes

JSON exige des guillemets doubles autour des clés et des chaînes.

Problème
json.loads("{'name': 'Ada'}")
Correction
json.loads('{"name": "Ada"}')

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.

S'entraîner avec un défi

Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.

Tous les défis