pip

À quoi ça sert

pip est l'outil qui installe des paquets Python depuis PyPI, le dépôt officiel de la communauté Python (FastAPI, NumPy, requests… tout est là). C'est lui qui télécharge, résout les dépendances et copie les fichiers dans ton environnement.

Il est livré avec Python depuis la version 3.4 — donc dès que tu as Python, tu as pip. C'est pour ça qu'on le croise partout : tutos en ligne, vieux projets, scripts CI, images Docker… Même si UV est plus rapide et plus moderne, savoir lire et écrire des commandes pip reste indispensable.

Un exemple d'usage

Tu récupères un projet sur GitHub avec un requirements.txt. Le workflow classique pip + venv tient en 4 commandes :

git clone <url-du-repo>
cd <dossier>
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Tu obtiens un environnement isolé (.venv/) dans lequel sont installés pile les paquets listés dans requirements.txt. Tu peux ensuite lancer le projet sans risquer de polluer ton Python système.

How-to : installer et utiliser pip

1. Vérifier que pip est là

   Si tu as Python ≥ 3.4, pip est déjà installé. Pour le confirmer :

   bash Copier

   python3 -m pip --version

   Tu devrais voir un truc comme pip 24.0 from … (python 3.12). Si la commande échoue, installe Python depuis python.org (l'installeur Windows propose une case "Add Python to PATH" — coche-la).

   Astuce

   Préfère python3 -m pip à pip tout court : ça garantit que tu utilises pip de la bonne version de Python, pas celui d'un autre Python installé ailleurs.

2. Créer un environnement virtuel

   Un venv isole les paquets d'un projet pour ne pas mélanger les dépendances entre projets (ni polluer le Python système). Crée-en un dans le dossier de ton projet :

   bash Copier

   python3 -m venv .venv

   Ça crée un dossier .venv/ avec une copie autonome de Python. Ajoute-le à ton .gitignore — il ne doit pas être versionné.

3. Activer le venv

   Sur Linux / macOS :

   bash Copier

   source .venv/bin/activate

   Sur Windows (PowerShell) :

   powershell Copier

   .venv\Scripts\Activate.ps1

   Ton prompt affiche maintenant (.venv) au début. À partir d'ici, toute commande python ou pip tape dans ce venv. Pour sortir : deactivate.

4. Installer un paquet

   Avec le venv activé, installe ce dont tu as besoin :

   bash Copier

   pip install requests

   Tu peux aussi épingler une version exacte (pip install requests==2.31.0) ou installer plusieurs paquets d'un coup (pip install requests fastapi uvicorn).

5. Écrire un petit script d'exemple

   Crée main.py :

   python Copier

   import requests
   
   def main():
       r = requests.get("https://api.github.com")
       print("Status:", r.status_code)
   
   if __name__ == "__main__":
       main()

   Lance-le :

   bash Copier

   python main.py

   Tu devrais voir Status: 200.

6. Figer les dépendances dans un requirements.txt

   Pour qu'une autre personne (ou toi-même plus tard) puisse réinstaller exactement les mêmes versions, fige tout dans un fichier :

   bash Copier

   pip freeze > requirements.txt

   Le fichier liste tous les paquets installés (et leurs sous-dépendances), un par ligne, avec leur version exacte. Versionne-le avec ton code.

   Limite à connaître

   pip freeze mélange tes dépendances directes (requests) et celles installées en cascade (charset-normalizer, idna…). C'est fonctionnel mais moins propre qu'un vrai fichier de lock comme uv.lock ou poetry.lock, qui sépare les deux.

7. Réinstaller depuis un requirements.txt

   C'est la commande qu'on tape sur tous les projets Python existants. Une fois le venv activé :

   bash Copier

   pip install -r requirements.txt

8. Configurer VS Code sur ce venv

   Pour que VS Code utilise le bon Python :

   1. Installe l'extension Python de Microsoft.
   2. Ouvre la palette (Ctrl+Shift+P / Cmd+Shift+P).
   3. Tape Python: Select Interpreter.
   4. Choisis ./.venv/bin/python (ou .venv\Scripts\python.exe sur Windows).

   VS Code activera automatiquement le venv dans ses terminaux et utilisera la bonne version de Python pour l'autocomplétion et le débogage.

Aide-mémoire des commandes

# Environnement virtuel
python3 -m venv .venv          # créer le venv
source .venv/bin/activate      # activer (Linux/macOS)
.venv\Scripts\Activate.ps1       # activer (Windows)
deactivate                       # quitter le venv

# Installer / désinstaller
pip install <paquet>            # dernière version
pip install <paquet>==1.2.3     # version exacte
pip install --upgrade <paquet>  # mettre à jour
pip uninstall <paquet>          # retirer

# Inspecter
pip list                        # paquets installés
pip show <paquet>               # détails d'un paquet
pip list --outdated             # versions périmées

# Requirements
pip freeze > requirements.txt   # figer
pip install -r requirements.txt # réinstaller

Pour aller plus loin

• Documentation officielle : pip.pypa.io
• Index des paquets : pypi.org
• Module venv : docs.python.org/3/library/venv.html
• Alternative moderne : la fiche UV sur ce site.