Formations — 1 037 leçons en français

Accueil › Python › CSV : le module, et pourquoi on ne découpe pas à la main

CSV : le module, et pourquoi on ne découpe pas à la main

Données, JSON et APIavance

Un CSV n'est pas « du texte séparé par des virgules ». C'est un format avec des règles de citation, et le module csv est là pour les appliquer.

import csv
from pathlib import Path

with Path("commandes.csv").open(newline="", encoding="utf-8") as f:
    for ligne in csv.DictReader(f):
        print(ligne["client"], ligne["total"])

DictReader lit la première ligne comme en-tête et rend un dict par ligne suivante. En écriture, le symétrique :

with Path("export.csv").open("w", newline="", encoding="utf-8") as f:
    w = csv.DictWriter(f, fieldnames=["id", "client", "total"])
    w.writeheader()
    w.writerow({"id": 42, "client": "Amélie", "total": "19.90"})

Trois règles qui évitent la quasi-totalité des bugs :

  1. newline="" toujours, en lecture comme en écriture.
  2. Précisez l'encodage. utf-8 en général, utf-8-sig pour un fichier venu d'Excel.
  3. Tout ce que csv renvoie est une str. Aucune conversion automatique : int(...), float(...) ou Decimal(...) sont à votre charge, et une cellule vide vous donne "", pas None.

Et la règle qui résume la leçon : on ne découpe jamais un CSV avec split(",").

Les termes à connaître

csv.reader

Itère sur un fichier ouvert et renvoie chaque ligne sous forme de list[str]. Il gère les guillemets, les séparateurs à l'intérieur d'un champ et les retours à la ligne échappés — ce que split(",") ne fait pas.

csv.DictReader

Même chose, mais chaque ligne devient un dict dont les clés viennent de la première ligne du fichier (l'en-tête). Plus lisible et robuste au réordonnancement des colonnes : ligne["prix"] ne bouge pas si une colonne est insérée avant.

newline=""

Argument à passer à open() pour tout fichier CSV, en lecture comme en écriture. Il désactive la traduction des fins de ligne par Python et laisse le module csv s'en charger. Sans lui, l'écriture produit une ligne vide sur deux sous Windows, et la lecture peut couper un champ contenant un saut de ligne.

utf-8-sig

Encodage à utiliser pour lire un CSV exporté par Excel : il retire le BOM (trois octets invisibles en tête de fichier). Sans lui, le premier nom de colonne devient "\ufeffid" et ligne["id"] lève KeyError.

Dialecte

L'ensemble des conventions d'un fichier CSV : séparateur (delimiter), caractère de citation (quotechar), échappement, fin de ligne. csv.reader(f, delimiter=";") suffit la plupart du temps ; csv.Sniffer peut tenter de le deviner.

DictWriter

Écrit des dictionnaires. Demande fieldnames à la construction et writeheader() pour poser la ligne d'en-tête. Une clé absente de fieldnames lève ValueError, une clé manquante dans la ligne est remplacée par restval.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.