Formations — 1 037 leçons en français

Accueil › Python › Lire et écrire un fichier : open, with, encodage

Lire et écrire un fichier : open, with, encodage

Texte et fichiersdebutant

Un fichier s'ouvre toujours dans un with :

with open("commandes.csv", "r", encoding="utf-8") as f:
    contenu = f.read()
# ici, le fichier est fermé — même si une exception a été levée dans le bloc

Les modes à connaître :

Mode Effet
"r" lecture (défaut) ; FileNotFoundError si absent
"w" écriture, vide le fichier à l'ouverture
"a" ajout en fin de fichier
"x" création ; FileExistsError si le fichier existe

Pour lire ligne à ligne sans charger le fichier entier, on boucle sur l'objet fichier :

with open("commandes.csv", encoding="utf-8") as f:
    entete = next(f)
    for ligne in f:
        reference, produit, quantite = ligne.rstrip("\n").split(";")

Le rstrip("\n") n'est pas décoratif : chaque ligne lue conserve son saut de ligne.

Et pour écrire :

with open("rapport.txt", "w", encoding="utf-8") as f:
    f.write("Rapport du jour\n")
    f.writelines(f"{nom};{total}\n" for nom, total in ventes)

write n'ajoute aucun saut de ligne, et writelines non plus : c'est à vous de les mettre.

Enfin, la règle qui évite le plus d'ennuis : précisez toujours encoding="utf-8".

Les termes à connaître

open

Ouvre un fichier et renvoie un objet fichier. Signature utile : open(chemin, mode="r", encoding=None, newline=None). Elle ne lit rien : elle donne un curseur sur lequel on appelle ensuite read, readline ou une boucle for.

Mode d'ouverture

"r" lecture (défaut), "w" écriture en vidant le fichier, "a" ajout en fin, "x" création exclusive (FileExistsError si le fichier existe), "r+" lecture-écriture. Un "b" ajouté ("rb") travaille en octets : ni encodage, ni traduction des sauts de ligne.

with (gestionnaire de contexte)

with open(...) as f: garantit la fermeture du fichier à la sortie du bloc, même si une exception est levée. C'est la seule forme à écrire ; sans elle, la fermeture dépend du ramasse-miettes.

Encodage

La règle qui traduit des caractères en octets. Sans paramètre encoding, Python utilise celui de l'environnement — qui n'est pas le même sur votre machine, celle du collègue et le serveur. Écrivez toujours encoding="utf-8".

UnicodeDecodeError

Levée quand les octets lus ne respectent pas l'encodage annoncé. Message typique sous Windows avec l'encodage local : UnicodeDecodeError: 'charmap' codec can't decode byte 0x81 in position 42: character maps to <undefined>. Signe quasi certain qu'il manque encoding="utf-8".

Curseur de lecture

Position courante dans le fichier. Après un read() complet, le curseur est à la fin : un second read() renvoie une chaîne vide. f.seek(0) revient au début.

newline

Contrôle la traduction des fins de ligne. En lecture, le mode texte convertit \r\n et \r en \n (« universal newlines »). En écriture, \n peut être traduit en fin de ligne du système : pour le module csv, il faut impérativement newline="".

Lire l'explication détaillée et faire le quiz →

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.