Introduction
Lorsque vous développez un projet Python, vous allez forcément utiliser des bibliothèques externes comme Flask, Django, NumPy ou Pygame. Pour les installer, les gérer et les partager efficacement, Python fournit deux outils incontournables : pip, le gestionnaire de paquets, et requirements.txt, le fichier qui liste toutes les dépendances d’un projet.
Dans cet article, vous apprendrez à installer, mettre à jour et supprimer des packages avec pip, à créer un fichier requirements.txt pour vos projets, et à gérer vos dépendances de manière professionnelle.
1. Installer un package avec pip
pip install nom_du_package
Exemple :
pip install flask
2. Spécifier une version
Pour garantir que le projet fonctionne avec la bonne version :
pip install flask==2.2.5
Ou pour une version minimale :
pip install flask>=2.0.0
3. Voir les packages installés
pip list
4. Mettre à jour un package
pip install --upgrade flask
5. Supprimer un package
pip uninstall flask
6. Qu’est-ce que requirements.txt ?
C’est un fichier texte qui contient la liste des packages utilisés dans un projet, avec leur version exacte.
Exemple :
flask==2.2.5
requests==2.31.0
7. Générer un fichier requirements.txt automatiquement
Lorsque vous avez installé toutes vos dépendances, utilisez :
pip freeze > requirements.txt
Cela crée un fichier listant tous les paquets et leurs versions.
8. Installer les dépendances depuis requirements.txt
Lorsque vous partagez un projet, d'autres personnes peuvent réinstaller tous les packages d’un coup :
pip install -r requirements.txt
9. Éviter les dépendances inutiles
Avant de faire un pip freeze, il est recommandé d’utiliser un environnement virtuel (voir article précédent sur venv) pour éviter d’inclure des packages globaux inutiles.
10. Utiliser un fichier requirements.txt versionné
Incluez ce fichier dans votre dépôt Git pour que n’importe quel collaborateur puisse cloner le projet et installer tout le nécessaire immédiatement.
11. Supprimer tous les packages installés
⚠️ À utiliser avec précaution :
pip freeze > packages.txt
pip uninstall -y -r packages.txt
12. Exemple de flux de travail propre
- Créez un environnement virtuel :
python -m venv .venv
source .venv/bin/activate
Installez vos packages :
pip install flask numpy
Générez le fichier :
pip freeze > requirements.txt
Ajoutez-le à votre dépôt Git.
Pour tout réinstaller ailleurs :
pip install -r requirements.txt
Conclusion
La gestion des dépendances avec pip et requirements.txt est une compétence de base essentielle pour tout développeur Python. Elle garantit la portabilité, la réplicabilité et la maintenabilité de vos projets, que ce soit en solo ou en équipe. Bien utilisée, cette méthode vous fera gagner un temps précieux et évitera bien des maux de tête liés aux conflits de versions.