Fichiers CSV en Python - Chicoree

1 Mon fichier CSV de test

Dans la suite de ce document, les exemples reposeront sur le fichier de test CSV suivant:

2 Principes généraux du module Python CSV

Le module Python csv repose sur deux classes principales:

3 Lecture d'un flux CSV

L'exemple le plus basique d'utilisation consiste à lire un flux CSV à partir d'un fichier:

3.1 Lecture à partir d'un fichier

L'exemple le plus basique d'utilisation consiste à lire un flux CSV à partir d'un fichier:

3.2 Extraction de colonnes

Comme le laisse supposer l'affichage précédent, chaque ligne extraite dans la boucle for est une liste. Il est donc facile d'accéder aux éléments individuels de chaque enregistrement – par exemple pour extraire la première et la troisième colonne:

3.3 Lecture dans un dictionnaire

En plus du lecteur utilisé jusqu'à présent, le module csv offre la classe csv.DictReader qui permet de récupérer les enregistrements sous la forme d'un dictionnaire plutôt que d'un tableau. Celle-ci se base sur la convention qui veut que le nom des colonnes soit donné dans le premier enregistrement (la première ligne):

3.4 Dialectes

Le problème majeur du format CSV est son manque de standardisation ce qui a donné naissance à différents dialectes. Ainsi, normalement la virgule est utilisée pour séparer les champs. Mais d'autres caractères sont aussi couramment utilisés. En particulier le point-virgule dans les logiciels francisés: en effet, ce caractère permet d'éviter la confusion avec la virgule du séparateur décimal. Mais il existe également d'autres variations, et à y regarder de plus près, bien d'autres formats de fichiers peuvent s'apparenter à du CSV. Par exemple, sur un système Unix, les fichiers /etc/passwd ou /etc/groups peuvent être assimilés à des fichiers CSV dont le séparateur serait le deux-points.

3.5 Type des données numériques

Jusqu'à présent, toutes les données que nous avons relues l'étaient sous forme de chaînes de caractères. Or, souvent, le format CSV est utilisé pour échanger des données numériques. Le module csv offre la possibilité de faire la conversion automatiquement des données numériques. Celles-ci seront identifiées comme telles par le module csv si elles respectent la syntaxe de Python pour les nombres et si elles ne sont pas encadrées par des délimiteurs de chaîne dans le document CSV source.

4 Écrire dans un flux CSV

Maintenant que nous avons passé beaucoup de temps sur la lecture d'un flux CSV, abordant au passage la notion de dialecte, l'écriture ne devrait pas être compliquée à comprendre. Ainsi, puisque le module csv definit un reader pour lire un flux CSV, comme on peut l'espérer il définit aussi un writer pour écrire dans un flux:

4.1 Générer un flux CSV

4.2 Dialecte pour l'écriture

Les exemples de la section précédente ne posaient pas de problèmes majeurs à csv puisque les données ne contenaient aucun des caractères spéciaux reconnus dans un fichier CSV. A savoir, en standard, la virgule, les guillemets et le retour à la ligne. Voyons maintenant comment il se comporte avec des données piégées:

5 Support Unicode et données binaires

La documentation du module cvs insiste sur le fait que celui-ci ne supporte pas les données Unicode. En réalité, pour être plus précis, le problème est surtout le non-support des encodages UTF-16 et UTF-32. Or les chaînes unicode Python utilisent un de ces deux encodages. À cela, il faut ajouter des problèmes avec les données contenant le caractère NUL. Pour toutes ces raisons, il est préférable de limiter l'usage de ce module à des données ASCII ou unicode encodées en UTF-8. Ce qui exclu aussi l'import/export direct de données binaires à l'aide de ce module. Si vous devez absolument manipuler de telles données, il sera sans doute judicieux de passer par un encodage capable de représenter les données binaires en ASCII (comme Base64, par exemple).

6 Un dernier mot

Si cet article est déjà long, il passe quand même sous silence un certain nombres d'options et de fonctionnalités du module Python csv. Comme toujours, la lecture du manuel de référence apportera plus de lumière sur les points laissés dans l'ombre. Néanmoins, vous devriez pouvoir disposer du nécessaire pour importer/exporter vos données au format CSV dans le cas général. Et même au delà, puisque comme nous l'avons vu, ce module est assez souple pour s'adapter à d'autre format de fichiers texte délimité.