pathlib

Les chemins comme objets : assemblage avec l’opérateur /, lecture des parties d’un chemin et travail sur les fichiers.

Sur cette page

Exemple

#
Python
from pathlib import Path

lesson = Path("cours") / "python" / "lecon_01.py"

print(lesson)
print(lesson.name)
print(lesson.stem, lesson.suffix)
print(lesson.parent)
print(lesson.with_suffix(".md"))
Résultatrésultat enregistré, vous pouvez le vérifier
cours/python/lecon_01.py
lecon_01.py
lecon_01 .py
cours/python
cours/python/lecon_01.md

Résultat pour Linux et macOS. Sous Windows, les chemins seront affichés avec des antislashs, par exemple cours\python\lecon_01.py.

Définition et utilisation

#

Le module pathlib représente les chemins comme des objets de la classe Path, et non comme de simples chaînes. On assemble les parties avec l’opérateur / : Path("cours") / "python". Le séparateur est choisi automatiquement, le même code fonctionne donc sous Windows, Linux et macOS.

Un objet chemin possède des attributs décrivant ses parties : name (le nom complet du fichier), stem (le nom sans l’extension), suffix (l’extension) et parent (le dossier parent). Des méthodes comme with_suffix() ou with_name() créent de nouveaux chemins sans toucher au disque.

Les autres méthodes agissent sur les fichiers : exists(), is_file(), mkdir(), read_text(), write_text(), unlink() (suppression d’un fichier), ainsi que glob() et rglob() pour rechercher des fichiers selon un motif. Dans du nouveau code, pathlib est l’alternative recommandée aux fonctions de os.path.

Syntaxe

#
Syntaxe
from pathlib import Path

Path("dossier") / "fichier.txt"
chemin.name, chemin.stem, chemin.suffix, chemin.parent
chemin.read_text(encoding="utf-8")
chemin.write_text(texte, encoding="utf-8")
chemin.glob(motif)

Plus d’exemples

#
Écrire et lire un fichier texte
Python
from pathlib import Path

notes = Path("notes.txt")
notes.write_text("Boucle for\nDictionnaires\n", encoding="utf-8")

print(notes.exists())
print(notes.read_text(encoding="utf-8").splitlines())

notes.unlink()
print(notes.exists())
Résultatrésultat enregistré, vous pouvez le vérifier
True
['Boucle for', 'Dictionnaires']
False
Créer des dossiers et rechercher des fichiers
Python
from pathlib import Path

src = Path("projet") / "src"
src.mkdir(parents=True, exist_ok=True)

for name in ["main.py", "utils.py", "README.md"]:
    (src / name).write_text("", encoding="utf-8")

print(sorted(path.name for path in Path("projet").rglob("*.py")))
Résultatrésultat enregistré, vous pouvez le vérifier
['main.py', 'utils.py']

Le résultat suppose que le dossier projet n’existait pas auparavant ou ne contenait pas d’autres fichiers .py.

Bonnes pratiques

#
  • Avec read_text() et write_text(), indiquez toujours encoding="utf-8", afin que les caractères accentués fonctionnent de la même façon sur tous les systèmes.
  • Vous pouvez passer un objet Path directement à open() et à la plupart des fonctions qui acceptent un chemin. Vous le convertissez en chaîne avec str().
  • Path.cwd() renvoie le dossier courant, et Path.home() le dossier personnel de l’utilisateur.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.