Pour utiliser une bibliothèque Python, on l'importe en haut du script avec import nom, puis on appelle ses fonctions avec la notation nom.fonction(). Si la bibliothèque ne fait pas partie de Python (pandas, requests, NumPy…), il faut d'abord l'installer avec pip, idéalement dans un environnement virtuel. La plupart des erreurs viennent de cette étape d'installation, pas de l'instruction import elle-même.
Module, paquet, bibliothèque : de quoi parle-t-on ?
Un module est un simple fichier .py qui contient des fonctions, des classes ou des variables. Un paquet est un dossier qui regroupe plusieurs modules. « Bibliothèque » est le terme courant pour désigner un ensemble de modules ou de paquets que vous réutilisez plutôt que de tout coder vous-même.
Il en existe deux familles. La bibliothèque standard est livrée avec Python : math, datetime, csv, json, pathlib s'importent sans rien installer. Les bibliothèques tierces, comme pandas ou requests, sont publiées sur PyPI et doivent être installées avant le premier import.
Les quatre façons d'importer
La forme de base charge le module et vous oblige à préfixer chaque appel par son nom :
import math
print(math.sqrt(16)) # 4.0
Avec from … import, vous récupérez un nom précis, utilisable sans préfixe :
from datetime import date
print(date.today())
Le mot-clé as donne un alias. Certaines bibliothèques ont des alias devenus des conventions que tout le monde reconnaît :
import pandas as pd
import numpy as np
import matplotlib.pyplot as plt
Reste from module import *, qui importe tous les noms publics d'un coup. Le tutoriel officiel sur les modules le déconseille : on ne sait plus d'où vient chaque nom, et un import peut écraser une variable déjà définie. Réservez-le à des tests rapides dans la console.
Quelle forme choisir ?
| Situation | Forme conseillée | Exemple |
|---|---|---|
| Vous utilisez plusieurs fonctions d'un module | import module | import os puis os.listdir() |
| Vous utilisez une ou deux fonctions, souvent | from module import nom | from pathlib import Path |
| Le nom du module est long ou a un alias d'usage | import module as alias | import pandas as pd |
| Deux modules ont une fonction du même nom | import module pour garder le préfixe | math.log et numpy.log |
Une idée reçue à corriger : importer une seule fonction avec from math import sqrt ne rend pas le programme plus rapide. Le module est chargé en entier dans les deux cas, seul le nom disponible dans votre script change. Le choix est une question de lisibilité. Autre détail utile : un module n'est importé qu'une fois par session, même si l'instruction import apparaît plusieurs fois.
Installer une bibliothèque tierce proprement
Avant d'importer pandas ou requests, installez-les. La méthode recommandée par la documentation Python sur les environnements virtuels consiste à créer un environnement par projet, pour que chaque projet ait ses propres versions :
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate
python -m pip install pandas
python -m pip freeze > requirements.txt
Le fichier requirements.txt liste les versions installées. Un collègue, ou vous-même sur un autre poste, recrée le même environnement avec python -m pip install -r requirements.txt. Écrire python -m pip plutôt que pip garantit que le paquet s'installe pour le Python que vous utilisez réellement. Le détail des commandes pip est expliqué dans notre guide pour installer et utiliser pip.
ModuleNotFoundError et autres erreurs d'import
Le message ModuleNotFoundError: No module named 'xxx' est l'erreur la plus fréquente. Elle a quatre causes principales.
| Cause | Comment le vérifier | Correction |
|---|---|---|
| La bibliothèque n'est pas installée | python -m pip show pandas ne renvoie rien | python -m pip install pandas |
| Elle est installée pour un autre Python | Votre éditeur utilise un interpréteur différent de celui du terminal | Activer l'environnement virtuel et sélectionner le même interpréteur dans l'éditeur |
| Le nom d'installation diffère du nom d'import | La documentation du paquet indique un autre nom | pip install scikit-learn puis import sklearn ; pip install Pillow puis import PIL ; pip install beautifulsoup4 puis import bs4 |
| Faute de frappe ou de casse | Relire le nom exact | Les noms d'import sont sensibles à la casse |
Un piège plus discret : nommer votre propre fichier comme une bibliothèque. Si votre script s'appelle pandas.py ou random.py, Python le trouve en premier, car le dossier du script passe avant les bibliothèques installées dans l'ordre de recherche. L'import charge alors votre fichier au lieu de la vraie bibliothèque, avec des erreurs du type AttributeError. Renommez le fichier et supprimez le dossier __pycache__ s'il en reste une trace.
Importer vos propres modules
Le même mécanisme sert à organiser votre code. Placez vos fonctions Python réutilisables dans un fichier outils.py, au même niveau que votre script, puis importez-les :
# outils.py
def calculer_ttc(prix_ht, taux_tva=0.2):
return round(prix_ht * (1 + taux_tva), 2)
if __name__ == "__main__":
print(calculer_ttc(100)) # test rapide, ignoré lors d'un import
# main.py
from outils import calculer_ttc
print(calculer_ttc(250))
Le bloc if __name__ == "__main__": ne s'exécute que si vous lancez outils.py directement. Quand le fichier est importé, ce code est ignoré. C'est l'endroit idéal pour un petit test du module.
Les bibliothèques à connaître pour un usage pro
| Besoin | Bibliothèque | À installer ? |
|---|---|---|
| Lire et écrire des fichiers CSV ou JSON | csv, json | Non, bibliothèque standard |
| Manipuler des dates | datetime | Non |
| Parcourir des dossiers et fichiers | pathlib, os | Non |
| Analyser des tableaux de données | pandas | Oui |
| Calcul numérique sur des tableaux | NumPy | Oui |
| Créer des graphiques | Matplotlib | Oui |
| Appeler une API web | requests | Oui |
| Lire et écrire des fichiers Excel | openpyxl | Oui |
Commencez par la bibliothèque standard : elle couvre déjà beaucoup de besoins d'automatisation sans aucune installation. Pour aller plus loin, voyez comment analyser des données avec pandas ou tracer un premier graphique avec Matplotlib.
Prochaine étape
Créez un dossier de projet, un environnement virtuel, installez pandas et importez-le dans un script qui lit un fichier CSV de votre activité. Si l'import échoue, reprenez le tableau des causes ci-dessus dans l'ordre. Pour progresser avec un formateur jusqu'à l'analyse de données, la formation Python à distance préparant la certification TOSA couvre les bases du langage, pandas, les bases de données et les graphiques, et elle est éligible au CPF.