T3.1 Tables de données

3.1.1 Données tabulées

Lorsqu'on souhaite manipuler des données, il est très fréquent de les présenter sous forme de tableaux: extrait de compte bancaire, bulletin scolaire, statistiques sportives, etc. On parle alors de données tabulées.

Ces tables sont le principal moyen de stocker des données structurées, et il est très important de savoir traiter efficacement ces données pour en tirer de l'information.

Vocabulaire

• une table est une collection d'enregistrements;
• chaque enregistrement contient des valeurs correspondant aux champs ou attributs de la table (des enregistrements).

pseudo	catégorie	score	classement
Gloxi	Fantômes	300	3
Letardigradefou	Fantômes	160	6
Cypher’s Clutch (Kayo, Killjoy)	Fantômes	131	7
cgouygou	Team Scully	677	1
clement_77	Team Scully	356	4
On vient chercher 2 trophées (ClementHammel, MathisHammel)	Loups-Garous	661	1

Dans la table ci-dessus, les champs/attributs sont 'pseudo', 'catégorie', 'score' et 'classement' et chaque ligne est un enregistrement.

Représentation des tables en Python

Puisque chaque enregistrement contient une valeur pour chaque champ de la table, il paraît naturel de représenter chaque enregistrement par un dictionnaire.

Par exemple, le deuxième enregistrement de la table précédente est

{'pseudo': 'Letardigradefou', 'catégorie': 'Fantômes', 'score': 160, 'classement': 6}

Une table sera donc représentée par une liste de dictionnaires.

3.1.2 Fichiers CSV

Les tables de données que nous manipulerons sont représentées par des fichiers au format csv (comma separated values) qui est un format fréquemment utilisé pour importer ou exporter des données tabulées.

C'est un simple fichier texte dans lequel la première ligne contient les champs, et chaque ligne suivante les enregistrements. Les champs et valeurs sont séparées par un délimiteur, généralement la virgule (comma in english).

Virgule ou point-virgule?

Il peut être nécessaire (comme dans l'exemple de la table précédente) de conserver la virgule pour séparer une valeur composite. On utilise alors parfois le point-virgule pour séparer les champs et valeurs... Lors de l'import d'un fichier csv avec un tableur, il faut préciser à l'ouverture quel délimiteur il faut utiliser.

Exercice

• Télécharger ce fichier et l'ouvrir avec LibreOffice Calc. Observer l'importance de préciser les délimiteurs.
• L'ouvrir ensuite avec l'éditeur de texte (gedit) pour observer sa construction.

Charger un fichier CSV avec Python

Avec une ouverture classique de fichier texte, les données importées sont sous forme d'une liste, dont la première valeur contient les champs, et les autres les enregistrements:

>>> data = open('pokedex.csv').read().splitlines()
>>> data[:5]
['No;Nom;Type;PV;Attaque;Défense;Vitesse;ASpé;DSpé;Talent;Nom US;code', '1;Bulbizarre;plante,poison;45;49;49;45;65;65;Engrais,Chlorophylle;Bulbasaur;77140', '2;Herbizarre;plante,poison;60;62;63;60;80;80;Engrais,Chlorophylle;Ivysaur;67530', '3;Florizarre;plante,poison;80;82;83;80;100;100;Engrais,Chlorophylle;Venusaur;65357', '4;Salamèche;feu;39;52;43;65;60;50;Brasier,Force Soleil;Charmander;10140']

Pour obtenir une liste de dictionnaires, il faudrait donc retravailler ces données (c'est un bon exercice, je vous le conseille...).

On va donc plutôt utiliser un module dédié à la manipulation de fichiers au format csv, le module ... csv:

import csv

with open('pokedex.csv') as f:       # (1)
    table = []
    for enregistrement in csv.DictReader(f, delimiter=';'): # (2)
        table.append(dict(enregistrement))

1. On charge le fichier dans une variable f
2. On applique la fonction DictReader du module csv au fichier en précisant le délimiteur, qui permet d'itérer sur les lignes du fichier en les transformant à l'aide des champs de la première ligne.

Exercice

1. Exécuter le code précédent et contrôler que la variable table est bien une liste de dictionnaires avec l'inspecteur d'objet de Thonny.
2. Le code précédent construit la liste table par ajouts successifs. Transformer le code pour la construire en compréhension.

3.1.3 Export en csv

Écrire un fichier CSV

Le module csv permet également d'exporter une table (c'est-à-dire une liste de dictionnaires...) vers un fichier CSV, avec la fonction DictWriter.

def export_csv(nomfichier: str, table: list, champs: list) -> None:
    '''
    Écrit dans un fichier le contenu d'une table connaissant ses champs.

    - nomfichier: le nom du fichier à créer, d'extension csv. S'il existe, il sera écrasé, 
    sinon il sera créé.
    - table: la table à exporter dans le fichier.
    - champs: une liste de str contenant les intitulés des champs de la table.
    '''
    with open(nomfichier, "w") as sortie:
        w = csv.DictWriter(sortie, champs)
        w.writeheader()
        w.writerows(table)