Accueil › Python › Modules et imports
Modules et imports
Modules, environnements et typageintermediaire
Un module, c'est un fichier .py. L'importer exécute ce fichier une fois, puis donne accès à ce qu'il définit.
# panier.py
TVA = 0.20
def total_ttc(prix):
return round(sum(prix) * (1 + TVA), 2)
Deux façons de s'en servir :
import panier # on garde le module
print(panier.total_ttc([10, 5]))
from panier import total_ttc # on garde seulement la fonction
print(total_ttc([10, 5]))
Les deux formes exécutent tout le fichier. La seule différence est le nom que vous obtenez : panier.total_ttc d'un côté, total_ttc de l'autre. La première garde l'origine visible dans le code appelant, ce qui aide à la lecture ; la seconde est plus courte.
Chaque module connaît son nom via la variable __name__. Quand le fichier est lancé (python panier.py), ce nom vaut "__main__". Quand il est importé, il vaut "panier". D'où l'idiome :
if __name__ == "__main__":
print(total_ttc([10, 5])) # ne s'exécute pas à l'import
Sans ce garde-fou, le code de démonstration d'un fichier se déclencherait chez quiconque l'importe.
Dernier point, celui qui explique le plus de bugs : un module n'est exécuté qu'une seule fois par processus. Python garde les modules chargés dans un dictionnaire, sys.modules ; les imports suivants y retrouvent l'objet déjà construit. C'est pour cette raison qu'un print au niveau d'un module n'apparaît qu'une fois, même importé dans dix fichiers — et c'est aussi ce cache qui rend les imports circulaires possibles à moitié, donc douloureux.
Les termes à connaître
- Module
Un fichier
.py. Son nom de module est le nom du fichier sans l'extension :panier.pydonne le modulepanier. C'est aussi un objet à l'exécution, avec des attributs — ses variables, fonctions et classes.- import
import panierexécute le fichierpanier.pyune seule fois, range le résultat danssys.modules, puis lie le nompanierdans votre fichier. Les imports suivants, où qu'ils soient, réutilisent l'objet déjà en mémoire.- from … import …
from panier import totalexécute le module entier, exactement commeimport, puis ne garde qu'une référence vers l'objettotal. Rien n'est « chargé partiellement » : la différence est uniquement le nom qu'on obtient.- __name__
Variable automatique de chaque module. Elle vaut le nom du module quand il est importé, et la chaîne
"__main__"quand le fichier est le point d'entrée lancé parpython fichier.py.- sys.modules
Le dictionnaire des modules déjà chargés, indexé par nom. C'est le cache qui fait qu'un module n'est exécuté qu'une fois par processus — et c'est aussi ce qui rend les imports circulaires possibles… à moitié.
- Import circulaire
Deux modules qui s'importent mutuellement. Le second import retrouve dans
sys.modulesun module partiellement initialisé : les noms définis plus bas dans le fichier n'existent pas encore.- Import absolu / relatif
Absolu :
from boutique.panier import total, le chemin complet depuis la racine. Relatif :from .panier import total, relatif au package courant. Le relatif ne fonctionne qu'à l'intérieur d'un package.
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.