Parcourir et lister des fichiers avec le module os

Introduction

En Python, le module os (pour operating system) permet d'interagir avec le système de fichiers de votre ordinateur : lister des fichiers, créer des dossiers, vérifier des chemins, etc. C'est un outil indispensable pour automatiser toute tâche impliquant des fichiers.

Pourquoi utiliser os pour parcourir des fichiers ?

Sans automatisation, explorer un dossier contenant des milliers de fichiers pour n'en garder que certains types serait extrêmement long. Avec os, quelques lignes de code suffisent.

Les fonctions essentielles du module os

1. Importer le module

1import os

2. Lister le contenu d'un dossier avec os.listdir()

Cette fonction renvoie une liste de tous les noms de fichiers et dossiers présents dans un répertoire donné.

1import os
2
3# Lister le contenu du dossier "Documents"
4contenu = os.listdir("Documents")
5print(contenu)
6
7# Résultat possible :
8# ['facture_001.pdf', 'photo.jpg', 'notes.txt', 'sous_dossier']

⚠️ Attention : os.listdir() renvoie aussi bien des fichiers que des dossiers, sans les distinguer directement ! Il faut vérifier leur nature avec d'autres fonctions.

3. Vérifier si c'est un fichier ou un dossier

1import os
2
3chemin = "Documents/facture_001.pdf"
4
5if os.path.isfile(chemin):
6    print("C'est un fichier")
7elif os.path.isdir(chemin):
8    print("C'est un dossier")

4. Parcourir récursivement avec os.walk()

Si vous devez explorer un dossier et tous ses sous-dossiers, os.walk() est l'outil parfait.

1import os
2
3for dossier_actuel, sous_dossiers, fichiers in os.walk("Documents"):
4    print(f"📁 Dossier : {dossier_actuel}")
5    for f in fichiers:
6        print(f"   📄 {f}")

os.walk() renvoie à chaque itération un triplet :

5. Filtrer les fichiers par extension

Pour ne garder que certains types de fichiers (ex : les PDF), on combine os.listdir() avec une condition sur le nom.

1import os
2
3dossier = "Documents"
4factures_pdf = []
5
6for element in os.listdir(dossier):
7    chemin_complet = os.path.join(dossier, element)
8    if os.path.isfile(chemin_complet) and element.endswith(".pdf"):
9        factures_pdf.append(element)
10
11print("Factures trouvées :", factures_pdf)

💡 À retenir : os.path.join() construit un chemin de fichier de manière sûre, en gérant automatiquement les séparateurs (/ sur Mac/Linux, \ sur Windows).

Comparatif des principales fonctions

Essayez par vous-même

Le saviez-vous ?

Points clés à retenir

💡 À retenir : os.listdir() explore un seul niveau de dossier, tandis que os.walk() explore récursivement tous les sous-dossiers. Choisissez la bonne fonction selon votre besoin !

⚠️ Attention : N'oubliez jamais de vérifier si un élément listé est un fichier ou un dossier avant de le traiter, sinon votre script risque de planter en tentant d'ouvrir un dossier comme un fichier.

🎯 En pratique : Pour un script de tri automatique de factures, combinez os.walk() (pour explorer tous les sous-dossiers) avec une condition sur l'extension (.endswith(".pdf")) pour ne garder que les fichiers pertinents.

Mini-quiz

En bref