Modules Python : Création, importation et utilisation avancée

Modules Python

Découvrez comment construire, importer et gérer les modules Python. Apprenez les bonnes pratiques, techniques d'importation avancées et chemins de recherche de modules.

Vidéo : Modules Python

Regardez un tutoriel approfondi sur les fondamentaux des modules.

Que sont les modules Python ?

Un module est simplement un fichier contenant des instructions et définitions Python. Par exemple, example.py est un module nommé example. Les modules aident à diviser les gros programmes en morceaux gérables et réutilisables. Définissez des fonctions communes une fois et importez-les où nécessaire.

Créons un petit module. Enregistrez ce qui suit sous example.py :

# example.py – un module d'addition simple
def add(a, b):
    """Retourne la somme de deux nombres."""
    return a + b

Comment importer des modules en Python

Utilisez le mot-clé import pour apporter un module dans l'espace de noms courant. Par exemple :

>>> import example

Accédez à son contenu via l'opérateur point :

>>> example.add(4, 5.5)
9.5

Python est livré avec une riche bibliothèque standard. Vous pouvez parcourir tous les modules sur Python Standard Library.

Instruction d'importation Python

# Importer le module math standard
import math
print("La valeur de pi est", math.pi)

La valeur de pi est 3.141592653589793

Importation avec renommage

# Importer math sous un alias plus court
import math as m
print("La valeur de pi est", m.pi)

Le renommage économise la frappe, mais rappelez-vous que le nom original (math) n'est plus disponible.

Instruction Python from…import

# Importer seulement la constante pi depuis math
from math import pi
print("La valeur de pi est", pi)

Plusieurs noms peuvent être importés en une ligne :

from math import pi, e
print(pi, e)

Importation de tous les noms

from math import *
print("La valeur de pi est", pi)

L'utilisation de * est déconseillée car elle pollue l'espace de noms et peut masquer d'où vient un nom.

Chemin de recherche des modules Python

Quand Python importe un module, il vérifie :

• Le répertoire courant.
• Les répertoires listés dans la variable d'environnement PYTHONPATH.
• Les répertoires par défaut spécifiques à l'installation de Python.

Inspectez la liste des chemins avec sys.path :

import sys
print(sys.path)
# ['', 'C:\Python33\Lib\idlelib', 'C:\Windows\system32\python33.zip', ...]

Rechargement d'un module

Les modules ne sont chargés qu'une fois par session d'interpréteur. Pour réévaluer un module modifié, utilisez importlib.reload() (le module imp est déprécié en Python 3). Exemple :

# my_module.py
print("Ce code a été exécuté")

>>> import my_module
Ce code a été exécuté
>>> importlib.reload(my_module)
Ce code a été exécuté

La fonction intégrée dir()

Utilisez dir() pour lister tous les attributs d'un module :

import example
print(dir(example))
# ['__builtins__', '__cached__', '__doc__', '__file__', '__name__', 'add']

Des attributs spéciaux comme __name__ révèlent les métadonnées du module :

print(example.__name__)
# 'example'

Appeler dir() sans arguments affiche tous les noms dans l'espace de noms courant.