HOWTO
Comment obtenir le répertoire courant des fichiers de script en Python
Il donne aux codes un exemple de comment obtenir le chemin du fichier script courant
Sur cette page
Pour obtenir le répertoire qui contient un script Python en cours d’exécution, utilisez os.path.dirname(os.path.abspath(__file__)) ou Path(__file__).resolve().parent. Ces deux expressions partent de __file__, le chemin associé au script, pour en déduire le répertoire qui le contient. Utilisez ce répertoire pour construire des chemins vers les fichiers situés à côté du script.
Obtenir le répertoire du script en cours d’exécution
Le répertoire d’un script est le dossier qui contient son fichier .py. __file__ fournit le chemin du script ; appliquer os.path.abspath(), puis os.path.dirname(), produit un chemin de répertoire absolu. Cette méthode est utile lorsqu’un script a besoin d’un fichier de configuration, d’entrée ou de données situé à proximité. Si __file__ est relatif, os.path.abspath() le résout à partir du répertoire de travail du processus ; le résultat peut donc dépendre de l’endroit depuis lequel Python a été lancé. Lorsque __file__ est déjà absolu, ce répertoire de travail ne détermine pas son emplacement.
Exécutez cet exemple depuis un fichier Python enregistré :
Le code et les libellés ou sorties affichés dans cette section restent en anglais.
import os
script_path = os.path.abspath(__file__)
script_directory = os.path.dirname(script_path)
directory, filename = os.path.split(script_path)
print("Script directory:", script_directory)
print("Directory and filename:", directory, filename)
Script directory: /work
Directory and filename: /work case-0.py
os.path.abspath() rend le chemin du script absolu en fonction du contexte du processus, et os.path.dirname() en extrait la partie correspondant au répertoire. os.path.split() renvoie le répertoire et le nom de fichier dans deux valeurs distinctes. Le répertoire affiché dépend de l’emplacement où vous enregistrez le fichier ; il n’existe donc pas de résultat littéral universel à recopier.
Distinguer le répertoire du script du répertoire de travail
Le répertoire de travail est l’emplacement du processus utilisé pour résoudre les chemins relatifs, par exemple dans open("data.csv"). Consultez-le avec os.getcwd(). Il peut s’agir du dossier courant du terminal, d’un répertoire défini dans un IDE ou d’un dossier choisi par un processus parent. Ce n’est pas nécessairement le dossier qui contient le script.
En revanche, __file__ désigne le chemin du fichier Python en cours d’exécution. Si un script situé dans /projects/tool est lancé alors que le répertoire de travail est /tmp, l’ouverture relative de data.csv est résolue à partir de /tmp ; un chemin construit à partir du répertoire du script pointe vers /projects/tool. Choisissez la base qui correspond à l’emplacement prévu pour le fichier. Pour un fichier placé à côté du script, joignez son nom au répertoire du script calculé avec os.path.join(script_directory, "data.csv").
Un chemin absolu dérivé de __file__ ne garantit pas que le fichier existe et ne règle pas tous les problèmes liés aux liens symboliques ou au déploiement. Il indique un emplacement à utiliser comme base ; vérifiez ou ouvrez le chemin obtenu selon les besoins de votre application.
Obtenir le répertoire du script avec os.path
L’exemple précédent conserve les valeurs intermédiaires afin de rendre chaque opération claire. Si seul le répertoire qui contient le script vous est nécessaire, combinez les appels ainsi : os.path.dirname(os.path.abspath(__file__)). Si les deux parties vous sont utiles, conservez le résultat de os.path.split() au lieu d’écarter le nom de fichier.
Pour construire le chemin d’un fichier voisin, utilisez os.path.join() plutôt que de concaténer des chaînes avec une barre oblique. Python applique ainsi les règles de séparateur de chemin de la plateforme. Par exemple, os.path.join(script_directory, "settings.json") crée un chemin ayant pour base le répertoire du script. En revanche, un nom de fichier relatif passé directement à open() est résolu à partir du répertoire de travail.
Obtenir le répertoire du script avec pathlib
pathlib exprime la même opération à l’aide d’objets chemin. Dans un script enregistré, Path(__file__).resolve().parent désigne le répertoire qui contient le script : resolve() obtient un chemin absolu résolu, et .parent sélectionne le dossier parent. Utilisez / pour ajouter un chemin enfant, par exemple script_directory / "settings.json", puis transmettez l’objet Path obtenu aux API qui acceptent les objets compatibles avec les chemins, notamment open().
L’expression équivalente est Path(__file__).resolve().parent ; importez Path depuis pathlib avant de l’utiliser. Préférez pathlib si le code environnant utilise déjà des objets Path, et os.path si vous travaillez avec des chaînes de chemin ou des API existantes qui les attendent. Aucune de ces approches ne modifie le répertoire de travail du processus.
Gérer les notebooks et les autres contextes d’exécution
__file__ est normalement défini lorsque Python exécute un script enregistré, mais les interpréteurs interactifs et les noyaux de notebook peuvent ne pas le définir. Dans ces contextes, les expressions fondées sur le script présentées plus haut ne permettent pas d’identifier le fichier d’un notebook de façon portable. os.getcwd() indique toujours le répertoire de travail du processus ; cela peut aider à localiser des fichiers par rapport à l’emplacement courant du noyau, mais ne remplace pas le chemin du fichier source du notebook.
Pour un fichier qui n’est pas le script en cours d’exécution, partez du chemin connu de ce fichier plutôt que de __file__, puis utilisez os.path.dirname() ou la propriété .parent de l’objet Path pour obtenir son répertoire. Indiquez explicitement la source du chemin afin que les lecteurs puissent déterminer s’il désigne le script, un autre fichier ou le répertoire de travail du processus.