Formations — 1 037 leçons en français

Accueil › Python › pathlib : des chemins qui marchent partout

pathlib : des chemins qui marchent partout

Texte et fichiersdebutant

pathlib remplace la manipulation de chemins à coups de chaînes. Un chemin devient un objet, et l'assemblage se fait avec / :

from pathlib import Path

base = Path("donnees")
fichier = base / "2026" / "ventes.csv"     # donnees/2026/ventes.csv sous Linux
                                            # donnees\2026\ventes.csv sous Windows

C'est le premier intérêt : plus aucun séparateur écrit à la main, donc un code qui fonctionne sur les deux systèmes.

Les morceaux du chemin sont des attributs :

fichier.name      # 'ventes.csv'
fichier.stem      # 'ventes'
fichier.suffix    # '.csv'
fichier.parent    # Path('donnees/2026')

Les opérations courantes sont des méthodes du chemin lui-même :

fichier.exists()                             # le fichier est-il là ?
fichier.read_text(encoding="utf-8")          # tout le contenu
fichier.write_text("a;b;c\n", encoding="utf-8")
fichier.parent.mkdir(parents=True, exist_ok=True)

for csv in base.rglob("*.csv"):              # parcours récursif
    print(csv.name)

Un objet Path ne garantit pas que le fichier existe : il décrit un chemin. C'est exists(), is_file() ou is_dir() qui interrogent le disque.

Les termes à connaître

Path

La classe centrale de pathlib. Path("donnees/commandes.csv") représente un chemin — pas un fichier : l'objet existe même si le fichier n'existe pas. Instancier Path donne un WindowsPath ou un PosixPath selon le système.

Opérateur /

Assemble des segments de chemin : Path("donnees") / "2026" / "ventes.csv". Le bon séparateur est choisi par le système. Si le segment de droite est absolu, il remplace tout ce qui précède.

name, stem, suffix, parent

name = dernier segment (ventes.csv), stem = sans l'extension (ventes), suffix = la dernière extension (.csv), suffixes = toutes, parent = le dossier contenant. Pour commandes.tar.gz, suffix vaut .gz et stem vaut commandes.tar.

read_text / write_text

Lisent ou écrivent tout le contenu en une ligne : chemin.read_text(encoding="utf-8"). Elles ouvrent et ferment le fichier elles-mêmes. Comme open, elles exigent un encoding explicite.

glob et rglob

Cherchent par motif : dossier.glob("*.csv") dans le dossier, dossier.rglob("*.csv") récursivement. Les deux renvoient un générateur, dans un ordre non spécifié : triez si l'ordre compte.

mkdir(parents, exist_ok)

Crée un dossier. Sans parents=True, échoue si un dossier intermédiaire manque (FileNotFoundError) ; sans exist_ok=True, échoue s'il existe déjà (FileExistsError). La forme habituelle est mkdir(parents=True, exist_ok=True).

resolve

Renvoie le chemin absolu, canonique, avec les .. résolus et les liens symboliques suivis. Indispensable avant de comparer deux chemins ou de vérifier qu'un chemin fourni par un utilisateur reste bien dans un dossier autorisé.

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.