Opération courante sous environnement python · leçon 9 sur 13

Sauvegarder son environnement

Le requirements.txt — la recette pour recréer votre projet en 10 secondes.

Plan du cours

Pour conclure

  1. Bilan du cours

01
Le problème du partage

Votre code fonctionne parfaitement avec vos bibliothèques. Vous voulez l'envoyer à un collègue ou le déployer sur un serveur. Le problème : vous ne pouvez pas lui envoyer votre dossier .venv.

❌ Pourquoi on ne partage pas .venv
  • Poids — plusieurs Go, parfois des centaines de milliers de fichiers
  • OS-spécifique — un .venv Windows ne fonctionne pas sur Mac
  • Chemins absolus — les fichiers de config pointent vers votre ordinateur personnel
✅ La solution — requirements.txt

On envoie la recette, pas le gâteau. Un simple fichier texte de quelques Ko qui liste ce qu'il faut installer — et chacun reconstruit son propre .venv en une commande.

02
Exporter sa configuration — pip freeze

Pour générer le fichier requirements.txt automatiquement, tapez :



TERMINAL

(.venv) $ pip freeze > requirements.txt
pip freeze
Demande à pip de lister absolument tout ce qui est installé avec les versions exactes (ex : pandas==2.1.4)
> fichier.txt
Le symbole ">" (redirection) prend la liste et, au lieu de l'afficher à l'écran, l'écrit dans un fichier texte.

Voici à quoi ressemble le fichier généré :



requirements.txt

numpy==1.26.2
pandas==2.1.4
scikit-learn==1.3.2
matplotlib==3.8.2
jupyter==1.0.0
...

03
Restaurer un environnement — pip install -r

Quand votre collègue reçoit votre projet (ou quand vous changez d'ordinateur), il suit ces 3 étapes :

1
Créer un nouveau python -m venv .venv
2
L'activer source .venv/bin/activate (ou .\.venv\Scripts\Activate.ps1 sur Windows)
3
La commande magique ↓


TERMINAL

(.venv) $ pip install -r requirements.txt
# pip lit le fichier et installe TOUT d'un coup
Collecting numpy==1.26.2...
Collecting pandas==2.1.4...
Successfully installed numpy pandas scikit-learn...
Le -r signifie read — "ne cherche pas un nom de paquet, lis ce fichier et installe tout ce qui s'y trouve, dans les versions exactes indiquées." En quelques secondes, l'environnement clone parfait du vôtre est recréé.

Exercice pratique

Simulez un transfert de projet :

  1. Dans votre projet avec bibliothèques installées, générez le requirements.txt
  2. Ouvrez ce fichier avec un éditeur de texte — observez les versions figées
  3. Créez un second dossier projet-clone/, copiez-y main.py et requirements.txt uniquement
  4. Créez un nouveau .venv, activez-le, et lancez pip install -r requirements.txt

À retenir — le cycle de vie d'un projet partagé
# Vous — avant de partager votre projet
$ pip freeze > requirements.txt
# Votre collègue — après avoir reçu le projet
$ python -m venv .venv
$ source .venv/bin/activate # ou Activate.ps1 sur Windows
$ pip install -r requirements.txt
# ✅ Environnement identique recréé en < 1 minute
  • On ne partage jamais le dossier .venv — on partage la recette
  • pip freeze > requirements.txt exporte · pip install -r requirements.txt restaure

Cours mis à jour en mars 2026.