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
readeretDictReaderrenvoient un itérateur de lignes (listes ou dictionnaires), etwriteretDictWriterun objet doté de méthodes d’écriture.
Exemple
#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))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
#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 avecopen(..., 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. DansDictWriter, ils sont obligatoires et fixent l’ordre des colonnes, dansDictReaderils sont facultatifs, pris par défaut dans la première ligne.
Plus d’exemples
#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)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())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.
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=";")))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()oufloat(), et les nombres à virgule décimale d’abord avecreplace(",", "."). - Pour analyser de grands tableaux, la bibliothèque pandas est plus pratique :
pd.read_csv("fichier.csv", sep=";").
Entrées associées
#- open()Ouvre un fichier en lecture ou en écriture et renvoie un objet fichier.
- withUn gestionnaire de contexte : préparation et nettoyage automatiques des ressources.
- jsonConvertit des données Python en texte JSON et inversement. La base de l’enregistrement de données et de la communication avec les API.
- str.split()Découpe une chaîne en une liste de parties selon un séparateur.
- next()Récupère l’élément suivant d’un itérateur. Une fois celui-ci épuisé, renvoie une valeur par défaut ou lève StopIteration.
- dict()Crée un dictionnaire à partir de paires clé-valeur ou d’arguments nommés.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.