csv

Lecture 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.

Renvoie
reader et DictReader renvoient un itérateur de lignes (listes ou dictionnaires), et writer et DictWriter un objet doté de méthodes d’écriture.
Sur cette page

Exemple

#
Python
import csv

students = [
    {"name": "Léa", "world": 7, "points": 250},
    {"name": "Jean", "world": 2, "points": 80},
]

with open("resultats.csv", "w", newline="", encoding="utf-8") as file:
    writer = csv.DictWriter(file, fieldnames=["name", "world", "points"])
    writer.writeheader()
    writer.writerows(students)

with open("resultats.csv", newline="", encoding="utf-8") as file:
    rows = list(csv.DictReader(file))

print(rows[0])
print(sum(int(row["points"]) for row in rows))
Résultatrésultat enregistré, vous pouvez le vérifier
{'name': 'Léa', 'world': '7', 'points': '250'}
330

Le fichier resultats.csv contient la ligne d’en-tête name,world,points et deux lignes de données. Après la lecture, toutes les valeurs sont des chaînes, c’est pourquoi les points doivent être convertis avec int().

Définition et utilisation

#

Le module csv lit et écrit des fichiers CSV, c’est-à-dire des tableaux sous forme de texte : chaque ligne du tableau est une ligne de texte, et les valeurs sont séparées par un séparateur, le plus souvent une virgule. Excel, Google Sheets et la plupart des bases de données exportent des données dans ce format. Le module gère correctement les valeurs qui contiennent le séparateur ou un guillemet, que l’on casse facilement en découpant à la main avec split(",").

csv.reader renvoie les lignes successives sous forme de listes de chaînes, et csv.DictReader sous forme de dictionnaires dont les clés sont les noms de colonnes de la première ligne. Pour l’écriture, il y a csv.writer avec les méthodes writerow() et writerows(), ainsi que csv.DictWriter, qui écrit l’en-tête avec la méthode writeheader(). Toutes les valeurs lues sont des chaînes, vous convertissez donc les nombres vous-même avec int() ou float().

Ouvrez le fichier avec l’argument newline="" et un encodage explicite, par exemple encoding="utf-8". Sans newline="", des lignes vides apparaissent entre les lignes sous Windows. La version française d’Excel utilise un point-virgule comme séparateur, que vous réglez avec le paramètre delimiter=";", et elle affiche correctement les caractères accentués si vous enregistrez le fichier avec l’encodage "utf-8-sig".

Syntaxe

#
Syntaxe
import csv

csv.reader(f, delimiter=",")
csv.writer(f, delimiter=",")
csv.DictReader(f)
csv.DictWriter(f, fieldnames=[...])

Paramètres

#
  • f

    objet fichier ou liste de chaînes

    Un fichier ouvert avec open(..., newline=""), ou toute collection de lignes de texte successives.
  • delimiter

    str, "," par défaut

    Le séparateur de valeurs, par exemple ";" pour les fichiers de la version française d’Excel.
  • fieldnames

    liste de chaînes

    Les noms des colonnes. Dans DictWriter, ils sont obligatoires et fixent l’ordre des colonnes, dans DictReader ils sont facultatifs, pris par défaut dans la première ligne.

Plus d’exemples

#
Pourquoi split(",") ne suffit pas
Python
import csv

lines = [
    "name,course,review",
    'Léa,Python,"Super, je recommande"',
    "Jean,HTML,Bien",
]

print(lines[1].split(","))
for row in csv.reader(lines):
    print(row)
Résultatrésultat enregistré, vous pouvez le vérifier
['Léa', 'Python', '"Super', ' je recommande"']
['name', 'course', 'review']
['Léa', 'Python', 'Super, je recommande']
['Jean', 'HTML', 'Bien']
Écriture avec point-virgule et guillemets
Python
import csv
import io

buffer = io.StringIO()
writer = csv.writer(buffer, delimiter=";", lineterminator="\n")
writer.writerow(["cours", "modules", "description"])
writer.writerow(["Python", 12, "Safari; Darwin"])
writer.writerow(["HTML", 11, 'Balises "à partir de zéro"'])

print(buffer.getvalue())
Résultatrésultat enregistré, vous pouvez le vérifier
cours;modules;description
Python;12;"Safari; Darwin"
HTML;11;"Balises ""à partir de zéro"""

Une valeur contenant le séparateur est mise entre guillemets, et un guillemet à l’intérieur d’une valeur est doublé. io.StringIO rassemble ici le texte en mémoire au lieu d’un fichier.

Un fichier pour la version française d’Excel
Python
import csv

with open("notes.csv", "w", newline="", encoding="utf-8-sig") as file:
    writer = csv.writer(file, delimiter=";")
    writer.writerow(["Élève", "Note"])
    writer.writerow(["Zoé", 5])

with open("notes.csv", newline="", encoding="utf-8-sig") as file:
    print(list(csv.reader(file, delimiter=";")))
Résultatrésultat enregistré, vous pouvez le vérifier
[['Élève', 'Note'], ['Zoé', '5']]

L’encodage utf-8-sig ajoute au début du fichier un marqueur BOM invisible, grâce auquel Excel reconnaît UTF-8 et affiche correctement les lettres accentuées.

Bonnes pratiques

#
  • Ouvrez les fichiers CSV avec newline="". Le module gère lui-même les fins de ligne, et sans cela des lignes vides apparaissent sous Windows.
  • Les valeurs du fichier sont toujours des chaînes. Convertissez les nombres avec int() ou float(), et les nombres à virgule décimale d’abord avec replace(",", ".").
  • Pour analyser de grands tableaux, la bibliothèque pandas est plus pratique : pd.read_csv("fichier.csv", sep=";").

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.