2.27. Lecture et écriture#

Les fichiers résident sur disque ; Python y accède via open(), qui renvoie un objet fichier dont les méthodes lisent et écrivent les octets sous-jacents.

2.27.1. open et les modes#

Le premier argument est le chemin ; le second est le mode – une courte chaîne qui indique à Python comment le fichier sera utilisé :

"r" – lecture (par défaut). Ouvre un fichier existant en lecture.
"w" – écriture. Crée un nouveau fichier ou tronque à vide un fichier existant.
"a" – ajout. Ouvre un fichier en écriture à sa fin, sans le tronquer.
"b" ajouté à l’un des modes ci-dessus ("rb", "wb", "ab") – mode binaire. Le contenu du fichier est de type bytes plutôt que str.

f = open("notes.txt", "r")
text = f.read()
f.close()

2.27.2. Utilisez un gestionnaire de contexte#

Le motif ci-dessus laisse fuir le descripteur de fichier si quoi que ce soit entre open() et close lève une exception. La solution est l’instruction with (voir gestionnaires de contexte) :

with open("notes.txt") as f:
    text = f.read()

# f is closed here, even if read() failed

C’est la forme standard – écrivez-la ainsi à chaque fois.

2.27.3. Lecture#

Les objets fichier prennent en charge plusieurs styles de lecture :

io.IOBase.read() – lit tout le fichier (ou N octets) et le renvoie sous forme d’une seule chaîne (ou objet bytes).
io.IOBase.readline() – lit une ligne, y compris le "\n" final.
Itérer directement le fichier produit les lignes une à une, avec une consommation mémoire bien moindre que la lecture du fichier entier d’un coup.

with open("log.txt") as f:
    for line in f:
        print(line.rstrip())

str.rstrip() supprime le saut de ligne final avant l’affichage afin que la sortie ne soit pas à double interligne.

2.27.4. Écriture#

Ouvrez le fichier en mode "w" et utilisez io.IOBase.write() :

with open("out.txt", "w") as f:
    f.write("hello\n")
    f.write("world\n")

io.IOBase.write() n’ajoute pas de saut de ligne – il écrit exactement les octets (ou les caractères, en mode texte) que vous lui donnez.

2.27.5. Texte ou binaire#

Le mode texte (par défaut, "r" / "w" sans "b") décode les octets entrants en str à l’aide d’un encodage par défaut, et encode les str sortants de nouveau en octets. Utilisez-le pour la configuration, les journaux, le JSON – tout ce qui est du texte.

Le mode binaire ("rb" / "wb") saute l’étape de décodage et renvoie des bytes. Utilisez-le pour les images, les enregistrements empaquetés par struct, les captures réseau – tout cas où chaque octet compte et où le fichier n’est pas lisible par l’humain.

2.27.6. Lister et supprimer des fichiers#

Le module os expose les opérations du système de fichiers qui ne figurent pas sur l’objet fichier lui-même :

os.listdir() – renvoie une liste des noms présents dans un répertoire.
os.remove() – supprime un fichier.
os.rename() – renomme un fichier.
os.stat() – métadonnées du fichier (taille, date de modification, …).
os.mkdir() – crée un nouveau répertoire.

import os

for name in os.listdir("/"):
    print(name)

Interceptez OSError autour de ces opérations lorsque le fichier ou le répertoire peut ne pas exister – l’opération est l’un des endroits courants où les exceptions apparaissent dans les scripts réels.