Aller au contenu
M03 · D. Manipuler les modules et les bibliothèques

Utiliser et installer des bibliothèques

Profiter de la bibliothèque standard de Python, installer des bibliothèques externes avec pip dans un environnement virtuel, et créer sa propre bibliothèque.

1Situer

Pour l'application du club de football de Safi, il faut tirer au sort les équipes, calculer l'âge des joueurs à partir de leur date de naissance, enregistrer les données en JSON et générer un tableau Excel pour le président. Tout réécrire prendrait des semaines. Des bibliothèques existent déjà pour chaque besoin : il suffit de savoir les trouver, les installer et les importer.

2Comprendre

D'où viennent les bibliothèques
Bibliothèque standard random datetimejson math csv re PyPIpypi.org .venv/ (projet) site-packages/ openpyxl ✓ pip install openpyxl from openpyxlimport Workbook

La bibliothèque standard est livrée avec Python : random, datetime, json... sont déjà là, on les importe directement.

1 / 5

Une bibliothèque est un ensemble de modules et de packages prêts à l’emploi. On en distingue deux sortes.

La bibliothèque standard

Elle est livrée avec Python : aucun téléchargement.

ModulePour
math, statisticscalculs, moyenne, médiane
randomtirages au sort, mélanges
datetimedates, heures, durées
json, csvlire et écrire des fichiers de données
os, pathlibfichiers et dossiers
reexpressions régulières
collectionsCounter, defaultdict, deque
tkinterinterfaces graphiques (leçon suivante)

Les bibliothèques externes et pip

Des centaines de milliers de bibliothèques sont publiées sur PyPI (pypi.org). On les installe avec pip, dans un terminal :

pip install openpyxl

Exemples utiles : requests (appels web), openpyxl (Excel), pandas (analyse de données), Pillow (images), PyQt ou wxPython (interfaces graphiques).

L’environnement virtuel

Pour que chaque projet ait ses bibliothèques, on crée un environnement virtuel :

python -m venv .venv
.venv\Scripts\activate         # Windows
pip install openpyxl
pip freeze > requirements.txt  # liste des dépendances

Un collègue recrée le même environnement avec pip install -r requirements.txt.

Créer sa propre bibliothèque

Votre package (un dossier avec __init__.py) devient une bibliothèque installable dès qu’on lui ajoute un fichier pyproject.toml qui donne son nom et sa version. pip install -e . l’installe ensuite dans l’environnement.

Exemple simple

La bibliothèque municipale

Vous n'écrivez pas un dictionnaire pour chercher un mot : vous l'empruntez. Les bibliothèques Python sont des livres de code déjà écrits, testés, et gratuits.

Exemple simple

Les piles fournies

Python est livré avec beaucoup de modules prêts à l'emploi : c'est la bibliothèque standard, on l'appelle « batteries included ». Pas besoin de pip pour eux.

import random, datetime
print(random.choice(["Salma", "Omar", "Hind"]))
print(datetime.date.today())

3Manipuler

Ce programme n'utilise que la bibliothèque standard, déjà installée. Changez la liste des joueurs, la graine du tirage (random.seed) ou les dates de naissance, puis relancez.
Pas à pas dans le lab ↗Python se charge au premier clic (environ 12 Mo, une seule fois).
Console

4Pratiquer

Exercice 1 · Installer une bibliothèque

Écrivez les commandes à taper dans un terminal pour créer un environnement virtuel, l'activer (Windows), installer la bibliothèque openpyxl et enregistrer la liste des dépendances.

Voir le corrigé
python -m venv .venv
.venv\Scripts\activate          (Linux/Mac : source .venv/bin/activate)
pip install openpyxl
pip freeze > requirements.txt

Exercice 2 · Le tableau Excel

Avec openpyxl (installée), créez un fichier joueurs.xlsx avec une ligne d'en-tête (Nom, Âge) puis une ligne par joueur.

Voir le corrigé
from openpyxl import Workbook

wb = Workbook()
ws = wb.active
ws.append(["Nom", "Âge"])
for nom, a in ages.items():
    ws.append([nom, a])
wb.save("joueurs.xlsx")

Exercice 3 · Votre propre bibliothèque

Vous avez écrit un package outils_club avec plusieurs modules. Comment le réutiliser dans un autre projet sans le copier ?

Voir le corrigé
Ajouter un fichier pyproject.toml (nom, version) à la racine
du package, puis l'installer dans l'environnement du projet :
pip install -e chemin/vers/outils_club
Il s'importe ensuite comme n'importe quelle bibliothèque :
from outils_club import tirage

5Vérifier

1. Quelle commande installe la bibliothèque externe requests ?
2. Faut-il installer le module random avec pip ?
3. À quoi sert un environnement virtuel (venv) ?