Le principe de la conversion CSV vers JSON
Un fichier CSV contient des lignes et des colonnes séparées par un caractère, généralement une virgule ou un point-virgule. Pour le convertir en JSON, chaque ligne devient un objet et chaque en-tête devient une clé.
Exemple de fichier CSV
nom,age,email
Alice,30,alice@example.com
Bob,25,bob@example.com
Résultat JSON
[
{
"nom": "Alice",
"age": "30",
"email": "alice@example.com"
},
{
"nom": "Bob",
"age": "25",
"email": "bob@example.com"
}
]
Dans cet exemple, la première ligne fournit les clés nom, age et email. Les valeurs sont généralement conservées sous forme de chaînes de caractères.
Convertir un CSV en JSON avec Python
Le module standard csv de Python permet d’utiliser DictReader. Lorsque aucun nom de champ n’est fourni, la première ligne du fichier est utilisée comme en-tête.
import csv
import json
with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
lignes = csv.DictReader(fichier_csv)
donnees = list(lignes)
with open("donnees.json", "w", encoding="utf-8") as fichier_json:
json.dump(donnees, fichier_json, ensure_ascii=False, indent=2)
DictReader associe les valeurs aux en-têtes, tandis que json.dump() écrit les objets dans le fichier JSON. L’option ensure_ascii=False conserve les accents et indent=2 rend le fichier plus lisible.
Convertir un CSV sans ligne d’en-tête
Si le fichier ne contient pas d’en-tête, fournissez les noms de colonnes avec fieldnames.
import csv
import json
en_tetes = ["nom", "age", "email"]
with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
lignes = csv.DictReader(fichier_csv, fieldnames=en_tetes)
donnees = list(lignes)
with open("donnees.json", "w", encoding="utf-8") as fichier_json:
json.dump(donnees, fichier_json, ensure_ascii=False, indent=2)
Lorsque fieldnames est utilisé, la première ligne du CSV est traitée comme une ligne de données. Vérifiez donc que le fichier ne contient réellement aucun en-tête.
Gérer un CSV séparé par des points-virgules
Certains tableurs exportent les données avec un point-virgule plutôt qu’une virgule. Indiquez alors le séparateur avec delimiter.
with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
lignes = csv.DictReader(fichier_csv, delimiter=";")
donnees = list(lignes)
Le séparateur doit correspondre au format réel du fichier. Selon l’application utilisée, il peut s’agir d’une virgule, d’un point-virgule, d’une tabulation ou d’un autre caractère.
Convertir un CSV en JSON avec JavaScript
Avec JavaScript, un analyseur CSV comme csv-parse peut utiliser la première ligne comme noms de colonnes grâce à l’option columns: true.
import fs from "node:fs";
import { parse } from "csv-parse/sync";
const csv = fs.readFileSync("donnees.csv", "utf8");
const donnees = parse(csv, {
columns: true,
skip_empty_lines: true
});
fs.writeFileSync("donnees.json", JSON.stringify(donnees, null, 2));
Il est aussi possible de fournir directement un tableau de noms de colonnes au lieu d’utiliser la première ligne du fichier.
Vérifications avant la conversion
- En-têtes : confirmez que la première ligne contient bien les noms des colonnes.
- Séparateur : vérifiez s’il s’agit d’une virgule, d’un point-virgule ou d’une tabulation.
- Guillemets : les champs contenant des virgules ou des retours à la ligne doivent être correctement entourés de guillemets.
- Nombre de colonnes : assurez-vous que chaque ligne contient le nombre attendu de champs.
- En-têtes uniques : évitez les noms dupliqués ou invalides afin de prévenir les clés ambiguës.
Convertir les types de données
La lecture avec csv.DictReader produit généralement des chaînes de caractères. Ainsi, "30" devient une chaîne JSON et non le nombre 30. Si des nombres, booléens ou valeurs nulles sont nécessaires, convertissez-les explicitement avant l’écriture.
for ligne in donnees:
ligne["age"] = int(ligne["age"])
Cette étape dépend de la structure attendue par l’application qui consommera le fichier JSON.