Accueil › Python › Environnements virtuels et dépendances
Environnements virtuels et dépendances
Modules, environnements et typageintermediaire
Par défaut, pip install dépose les bibliothèques dans l'installation Python de la machine — partagée par tous vos projets. Deux projets qui ont besoin de versions différentes d'une même bibliothèque ne peuvent alors pas cohabiter.
Un environnement virtuel est un dossier qui contient son propre interpréteur et ses propres bibliothèques.
python -m venv .venv # crée le dossier .venv
source .venv/bin/activate # Linux, macOS
.venv\Scripts\activate # Windows
Le terminal affiche alors (.venv) : python et pip désignent maintenant ceux du projet.
pip install httpx
pip freeze > requirements.txt # la photographie exacte de l'environnement
Sur une autre machine, on reconstruit le même environnement :
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
Le dossier .venv ne se commite pas : il est volumineux, lié au système d'exploitation, et entièrement reconstructible depuis la liste des dépendances. On commite la liste, pas le résultat.
Deux réflexes à prendre tout de suite. Quand une installation « ne prend pas », c'est presque toujours que pip et python ne désignent pas le même interpréteur : python -m pip install ... lève le doute, puisqu'il s'adresse par construction à l'interpréteur courant. Et si une commande pip réclame les droits d'administrateur, c'est le signe que vous visez le Python du système — créez un environnement plutôt que de forcer.
Les termes à connaître
- Environnement virtuel
Un dossier contenant un interpréteur Python et son propre jeu de bibliothèques, isolé du reste de la machine. Créé avec
python -m venv .venv. Chaque projet a le sien.- venv
Le module de la bibliothèque standard qui crée un environnement virtuel. Rien à installer : il est livré avec Python.
- Activation
Commande qui place le dossier
bin(ouScriptssous Windows) de l'environnement en tête duPATH. À partir de là,pythonetpipdésignent ceux du projet. Elle ne vaut que pour le terminal courant.- pip
L'installateur de paquets de Python. Il télécharge depuis l'index public et installe dans l'environnement de l'interpréteur qui l'exécute — d'où l'importance de savoir lequel c'est.
- Dépendance directe / transitive
Directe : ce que votre code importe. Transitive : ce que vos dépendances importent à leur tour. Un projet qui déclare trois paquets peut en installer quarante.
- Dépendances figées (*lock*)
La liste complète des paquets installés avec leur version exacte, telle que produite par
pip freeze. Elle sert à reconstruire un environnement identique ailleurs — c'est ce qui rend une installation reproductible.- requirements.txt
Fichier texte listant des paquets, un par ligne, installable avec
pip install -r requirements.txt. Historiquement le format d'échange le plus répandu ;pyproject.tomlle remplace peu à peu pour les dépendances déclarées.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.