HOWTO · Python

Importer une variable à partir d'un autre fichier en Python

Ce tutoriel montre comment importer une variable à partir d'un autre fichier en Python.

Sur cette page

Pour utiliser une variable définie dans un autre fichier Python, importez son module puis lisez la variable, ou liez directement son nom avec from module import name. Le module doit être accessible via le chemin d’importation de Python. Pour un petit projet, placez les deux fichiers dans le même répertoire et exécutez le script qui effectue l’import depuis ce projet.

Importer un nom précis avec from ... import ...

Supposons que config.py définisse greeting = "Hello, World!". Le fichier qui effectue l’import peut utiliser from config import greeting, puis référencer directement greeting. Le nom du module correspond au nom du fichier sans l’extension .py. Cette forme est pratique lorsque vous n’avez besoin que de quelques noms. Vous pouvez importer plusieurs noms connus en les séparant par des virgules, par exemple from config import greeting, language.

Exécutez cet exemple :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

from pathlib import Path
from tempfile import TemporaryDirectory
import sys

with TemporaryDirectory() as directory:
    project = Path(directory)
    (project / "config.py").write_text('greeting = "Hello, World!"\n', encoding="utf-8")
    sys.path.insert(0, str(project))
    from config import greeting
    print(greeting)

Cet exemple est destiné à être exécuté par le coordinateur d’exécution ; aucun résultat d’exécution n’est fourni dans ce paquet de rédaction.

Importer le module et accéder à sa variable

Utilisez import config, puis lisez config.greeting si vous souhaitez que le module source reste visible à chaque utilisation. Le préfixe du module indique clairement l’origine du nom et réduit les risques de conflit lorsque plusieurs modules définissent des noms identiques. Un import ordinaire lie également le nom importé au moment où l’import est exécuté ; si la valeur change ensuite dans le module source, le nom importé séparément ne devient pas pour autant un lien dynamique vers cette valeur.

Importer un module de façon dynamique avec importlib

Utilisez importlib lorsque le nom du module est choisi à l’exécution, par exemple à partir d’un paramètre ou d’un choix de l’utilisateur. Pour un module connu, un import normal est plus court et plus facile à suivre. Voici une forme dynamique autonome :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

from pathlib import Path
from tempfile import TemporaryDirectory
import importlib
import sys

with TemporaryDirectory() as directory:
    project = Path(directory)
    (project / "config.py").write_text('greeting = "Hello, World!"\n', encoding="utf-8")
    sys.path.insert(0, str(project))
    module_name = "config"
    module = importlib.import_module(module_name)
    print(module.greeting)

importlib.import_module() renvoie l’objet module ; vous pouvez donc accéder à la variable par cet objet. Le module doit toujours être accessible via le système d’importation.

Rendre importable un module situé dans un autre répertoire

Python recherche des répertoires dans son chemin d’importation, et non des fichiers arbitraires. Une structure simple consiste à placer project/main.py à côté de project/settings/config.py ; le contexte de lancement et la configuration du paquet déterminent si settings.config peut être importé. Pour un paquet classique, ajoutez __init__.py lorsque c’est nécessaire et utilisez le nom du paquet, par exemple from settings.config import greeting. Lancer le script depuis un autre répertoire peut modifier les emplacements recherchés par Python ; privilégiez donc une méthode de lancement cohérente pour le projet.

En dernier recours délibéré pour un script autonome, ajoutez à sys.path le répertoire qui contient le module, avant de l’importer. Si possible, déterminez ce répertoire à partir d’un emplacement stable au lieu de supposer qu’il s’agit du répertoire de travail courant :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

from pathlib import Path
from tempfile import TemporaryDirectory
import sys

with TemporaryDirectory() as directory:
    project = Path(directory)
    settings_directory = project / "settings"
    settings_directory.mkdir()
    (settings_directory / "config.py").write_text('greeting = "Hello, World!"\n', encoding="utf-8")
    sys.path.insert(0, str(settings_directory))
    from config import greeting
    print(greeting)

Cette opération ajoute un répertoire à sys.path ; elle n’y ajoute pas le fichier du module lui-même. Pour les applications maintenues dans la durée, les imports de paquet ou l’installation du paquet sont généralement plus faciles à gérer que la modification du chemin d’importation dans le code de l’application.

Exécuter les exemples et résoudre les problèmes

Enregistrez le module sous le nom exact utilisé dans l’import, en respectant notamment la casse, et vérifiez que la variable est définie au niveau du module. Si Python signale ModuleNotFoundError, vérifiez le nom du fichier, la structure des répertoires, la manière dont vous avez lancé le script et la présence du répertoire contenant le module dans le chemin d’importation. Si Python signale ImportError pour un nom, vérifiez que son orthographe correspond à celle d’un nom défini dans le module. Évitez de donner à vos fichiers le nom de modules de la bibliothèque standard, car Python pourrait alors charger le mauvais module.

Un import direct convient mieux à une dépendance fixe. Choisissez from config import greeting pour accéder simplement à quelques noms, ou import config si garder l’espace de noms du module visible améliore la clarté. Utilisez importlib lorsque le nom du module dépend réellement de données disponibles à l’exécution.