Formations — 1 037 leçons en français

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 (ou Scripts sous Windows) de l'environnement en tête du PATH. À partir de là, python et pip dé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.toml le remplace peu à peu pour les dépendances déclarées.

Lire l'explication détaillée et faire le quiz →

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.