Modules et imports Python : guide complet pour débutants

Les bases des modules en Python

Travailler avec des modules et organiser correctement les importations sont des aspects essentiels pour écrire un code Python propre, structuré et évolutif. Le puissant système de modules de Python permet d'utiliser des bibliothèques intégrées, des packages tiers et de créer vos propres modules.

Dans ce guide, nous allons explorer en détail le mécanisme des importations. Nous verrons comment utiliser des modules Python populaires comme os et sys. Nous étudierons également les principes d'une bonne structuration de projet pour exploiter facilement vos propres modules.

Qu'est-ce qu'un module en Python ?

Un module en Python est simplement un fichier avec l'extension .py. Il peut contenir des variables, des fonctions, des classes ou du code exécutable. Les modules peuvent être importés dans d'autres programmes pour réutiliser leurs fonctionnalités.

Utiliser des modules en Python permet de :

• Réutiliser le code déjà écrit
• Diviser un projet en parties logiques
• Améliorer la lisibilité du code
• Faciliter la maintenance et l'évolution des programmes
• Créer une architecture d'application plus structurée

Les différentes façons d'importer des modules en Python

Importation de base d'un module

La méthode la plus simple utilise le mot-clé import :

import math
print(math.sqrt(16))  # Résultat : 4.0

Dans cet exemple, nous utilisons le module intégré math. Il fournit diverses fonctions mathématiques pour effectuer des calculs.

Importation avec un alias

Importer un module avec un alias simplifie son utilisation :

import math as m
print(m.pi)  # Résultat : 3.141592653589793

Cette approche est pratique lorsque le module a un nom long. Elle est également utile si le module est utilisé fréquemment dans le code.

Importation de fonctions spécifiques

Vous pouvez importer uniquement les fonctions nécessaires depuis un module :

from math import sqrt
print(sqrt(25))  # Résultat : 5.0

Cette méthode permet d'appeler la fonction directement, sans avoir à préciser le nom du module.

Importation de tous les objets d'un module

Python permet d'importer tous les objets d'un module en une seule fois :

from math import *
print(sin(0))  # Résultat : 0.0

Cette approche est déconseillée. Elle réduit la lisibilité du code et augmente le risque de conflits de noms entre variables et fonctions.

Comment Python trouve-t-il les modules ?

Ordre de recherche des modules

Python recherche les modules dans l'ordre suivant :

• Le répertoire de travail actuel
• Les dossiers listés dans la variable d'environnement PYTHONPATH
• Les répertoires standards d'installation de Python
• Les dossiers site-packages

Vérifier les chemins de recherche

Vous pouvez afficher la liste des répertoires de recherche avec le module sys :

import sys
print(sys.path)

Cette commande affiche la liste complète des répertoires dans lesquels Python cherche les modules et packages importés.

Ajouter des chemins personnalisés

Si nécessaire, vous pouvez ajouter des chemins supplémentaires :

import sys
sys.path.append('/chemin/personnalise/vers/mes_modules/')

Travailler avec le module os en Python

Principales fonctionnalités du module os

Le module os offre des outils puissants pour interagir avec le système d'exploitation. Il permet d'effectuer des opérations sur les fichiers et les répertoires.

Obtenir le répertoire de travail actuel

import os
print(os.getcwd())

La fonction getcwd() retourne le chemin du répertoire de travail actuel.

Lister le contenu d'un répertoire

files = os.listdir('.')
print(files)