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 :
newline=""toujours, en lecture comme en écriture.- Précisez l'encodage.
utf-8en général,utf-8-sigpour un fichier venu d'Excel. - Tout ce que
csvrenvoie est unestr. Aucune conversion automatique :int(...),float(...)ouDecimal(...)sont à votre charge, et une cellule vide vous donne"", pasNone.
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 quesplit(",")ne fait pas.- csv.DictReader
Même chose, mais chaque ligne devient un
dictdont 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 modulecsvs'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"etligne["id"]lèveKeyError.- 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.Snifferpeut tenter de le deviner.- DictWriter
Écrit des dictionnaires. Demande
fieldnamesà la construction etwriteheader()pour poser la ligne d'en-tête. Une clé absente defieldnameslèveValueError, une clé manquante dans la ligne est remplacée parrestval.
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.