Formations — 1 037 leçons en français

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.py donne le module panier. C'est aussi un objet à l'exécution, avec des attributs — ses variables, fonctions et classes.

import

import panier exécute le fichier panier.py une seule fois, range le résultat dans sys.modules, puis lie le nom panier dans votre fichier. Les imports suivants, où qu'ils soient, réutilisent l'objet déjà en mémoire.

from … import …

from panier import total exécute le module entier, exactement comme import, puis ne garde qu'une référence vers l'objet total. 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é par python 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.modules un 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.

Lire l'explication détaillée et faire le quiz →

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.