D.1 Créer et importer des modules

1Situer

Le programme de la librairie fait maintenant 800 lignes dans un seul fichier. Pour corriger le calcul de la TVA, il faut chercher pendant dix minutes, et deux stagiaires ne peuvent pas travailler dessus en même temps sans se gêner. On le découpe en modules : un fichier pour les livres, un pour les calculs, un pour le programme principal.

2Comprendre

Ce que fait import

Deux fichiers dans le même dossier : outils.py contient des outils, main.py est le programme principal.

1 / 5

Un module est simplement un fichier .py. Tout ce qu’il définit (fonctions, classes, variables) peut être réutilisé dans un autre fichier grâce à import.

Créer un module

Écrivez vos fonctions dans outils.py. Placez main.py dans le même dossier. C’est tout : outils est devenu un module.

Exemple simple

Un module de calculs pour la boutique

Un module est simplement un fichier .py. Ses fonctions deviennent réutilisables partout.

# fichier calculs.py
TVA = 0.2
def ttc(ht):
    return ht * (1 + TVA)

# fichier main.py
import calculs
print(calculs.ttc(100))    # 120.0

Les façons d’importer

Écriture	Utilisation	Quand
`import outils`	`outils.tva(100)`	on voit d’où vient chaque nom
`from outils import tva, Ticket`	`tva(100)`	quelques noms utilisés souvent
`import outils as o`	`o.tva(100)`	nom de module long
`from outils import *`	`tva(100)`	à éviter : on ne sait plus d’où viennent les noms

Exemple simple

Trois façons d’importer la même fonction

Toutes donnent accès à ttc, avec des noms différents.

import calculs                 # calculs.ttc(100)
from calculs import ttc        # ttc(100)
import calculs as c            # c.ttc(100)

Ce qui se passe

import calculs garde le nom du module devant : on sait d’où vient la fonction.
from … import est plus court, mais attention aux noms en double.
as donne un surnom, pratique pour les noms longs.

Où Python cherche-t-il les modules ?

Dans l’ordre : le dossier du programme lancé, puis les dossiers de la bibliothèque standard, puis les bibliothèques installées avec pip. La liste complète est dans sys.path.

Le bloc `if name == "main"`

Quand Python importe un module, il exécute tout son code. Pour qu’une partie ne s’exécute que si on lance le fichier directement, on la protège :

if __name__ == "__main__":
    print("Test du module :", ttc(100))

Exemple simple

Un module qui se teste tout seul

Le code sous ce test s’exécute quand on lance le fichier directement, mais pas quand on l’importe.

# calculs.py
def ttc(ht):
    return ht * 1.2

if __name__ == "__main__":
    print("Test :", ttc(100))   # seulement avec : python calculs.py

Ce qui se passe

python calculs.py : __name__ vaut "__main__", le test s’affiche.
import calculs depuis main.py : __name__ vaut “calculs”, le test ne s’exécute pas.

Module et package

Plusieurs modules rangés dans un dossier avec un __init__.py forment un package (vu en C.1) : from centre.personnes import Stagiaire.

Exemple simple

Un package est un dossier de modules

Le dossier contient un fichier __init__.py et plusieurs modules.

boutique/
├── __init__.py
├── calculs.py
└── factures.py

from boutique.calculs import ttc

Exemple simple

La boîte à outils

Vous ne fabriquez pas un tournevis chaque fois que vous en avez besoin : vous le prenez dans la boîte à outils. Un module, c'est une boîte à outils de fonctions et de classes que d'autres programmes empruntent avec import.

import math
print(math.sqrt(144))   # 12.0

Exemple simple

Prendre seulement ce qu'il faut

On peut importer tout le module, ou seulement un outil, et même lui donner un surnom plus court.

import outils                 # outils.tva(100)
from outils import tva        # tva(100)
import outils as o            # o.tva(100)

3Manipuler

Le programme écrit d'abord un fichier outils.py dans la mémoire du navigateur, puis l'importe. Ajoutez une fonction remise(prix, pourcentage) dans le texte du module, et utilisez-la dans le programme principal.

Pas à pas dans le lab ↗Python se charge au premier clic (environ 12 Mo, une seule fois).

import sys, importlib

# --- Préparation (seulement pour ce bac à sable) : on crée le fichier outils.py
MODULE = '''
"""Outils de calcul pour la librairie."""
TAUX_TVA = 0.20

def tva(prix_ht):
    return round(prix_ht * TAUX_TVA, 2)

def ttc(prix_ht):
    return round(prix_ht + tva(prix_ht), 2)

class Ticket:
    def __init__(self):
        self.lignes = []
    def ajouter(self, libelle, prix_ht):
        self.lignes.append((libelle, ttc(prix_ht)))
    def total(self):
        return sum(p for _, p in self.lignes)

if __name__ == "__main__":
    print("Test du module :", ttc(100))
'''
with open("outils.py", "w", encoding="utf-8") as f:
    f.write(MODULE)
sys.path.insert(0, ".")
sys.modules.pop("outils", None)
importlib.invalidate_caches()
# --- Fin de la préparation

# Programme principal
import outils
from outils import Ticket, ttc

print("TVA sur 100 DH :", outils.tva(100))
print("Prix TTC :", ttc(45))

ticket = Ticket()
ticket.ajouter("Roman", 45)
ticket.ajouter("Cahier", 12)
print("Total du ticket :", ticket.total(), "DH")
print("Nom du module :", outils.__name__)

Entrées pour input(), séparées par des virgules

Console

4Pratiquer

Exercice 1 · Votre premier module

Créez (sur votre ordinateur) un fichier conversions.py avec deux fonctions dh_vers_euro(m) et euro_vers_dh(m), puis un fichier main.py dans le même dossier qui les importe et les utilise.

Voir le corrigé

# conversions.py
TAUX = 10.8
def dh_vers_euro(m):
    return round(m / TAUX, 2)
def euro_vers_dh(m):
    return round(m * TAUX, 2)

# main.py
from conversions import dh_vers_euro, euro_vers_dh
print(dh_vers_euro(108))   # 10.0
print(euro_vers_dh(5))     # 54.0

Exercice 2 · À quoi sert main ?

Dans le module outils, pourquoi le message « Test du module » ne s'affiche-t-il pas quand on fait import outils ? Quand s'afficherait-il ?

Voir le corrigé

Quand un fichier est importé, sa variable __name__ vaut le nom
du module ("outils"), donc le bloc if __name__ == "__main__"
est ignoré. Il ne s'exécute que si on lance directement le
fichier : python outils.py. On y met les tests du module.

Exercice 3 · Explorer un module

Affichez la liste des noms définis dans le module math, puis l'aide de la fonction math.floor.

Voir le corrigé

import math
print(dir(math))
help(math.floor)

Créer et importer des modules

1Situer

2Comprendre

Créer un module

Les façons d’importer

Où Python cherche-t-il les modules ?

Le bloc if __name__ == "__main__"

Module et package

La boîte à outils

Prendre seulement ce qu'il faut

3Manipuler

4Pratiquer

Exercice 1 · Votre premier module

Exercice 2 · À quoi sert __main__ ?

Exercice 3 · Explorer un module

5Vérifier

Le bloc `if name == "main"`

Exercice 2 · À quoi sert main ?