pathlib
Les chemins comme objets : assemblage avec l’opérateur /, lecture des parties d’un chemin et travail sur les fichiers.
Exemple
#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é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
#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
#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())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")))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()etwrite_text(), indiquez toujoursencoding="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
Pathdirectement àopen()et à la plupart des fonctions qui acceptent un chemin. Vous le convertissez en chaîne avecstr(). Path.cwd()renvoie le dossier courant, etPath.home()le dossier personnel de l’utilisateur.
Entrées associées
#- os vs pathlibos représente les chemins comme de simples chaînes manipulées par des fonctions ; pathlib représente un chemin comme un objet Path avec méthodes et l’opérateur /.
- osInteraction avec le système d’exploitation : chemins, dossiers, fichiers et variables d’environnement.
- open()Ouvre un fichier en lecture ou en écriture et renvoie un objet fichier.
- withUn gestionnaire de contexte : préparation et nettoyage automatiques des ressources.
- jsonConvertit des données Python en texte JSON et inversement. La base de l’enregistrement de données et de la communication avec les API.
- str.endswith()Vérifie si une chaîne se termine par un fragment donné.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.