Lister les dépendances du projet

Quand le suivi de dépenses devra interroger une API, le projet aura besoin d’un paquet Python qui simplifie les requêtes HTTP. Installer ce paquet sans garder de trace de sa version rend les installations sur d’autres machines incertaines. Vous allez ajouter requests au projet et enregistrer la dépendance dans requirements.txt.

Vous avez déjà créé et activé .venv dans la leçon précédente. Dans le terminal, vérifiez que cet environnement est toujours actif avant d’installer le paquet ; utilisez python -m pip afin d’associer explicitement pip à l’interpréteur Python courant.

python -m pip install "requests==2.32.3"

Collecte et installation de requests 2.32.3 et de ses dépendances nécessaires. Les messages exacts dépendent du système et des versions déjà présentes.

La version est précisée dans la commande : c’est une dépendance épinglée. Deux installations qui respectent ce numéro principal installent la même version de requests, ce qui limite les écarts de comportement entre postes. Le gestionnaire installe également les paquets dont requests a besoin ; vous n’avez pas à les ajouter manuellement à cette commande.

Le fichier requirements.txt est la liste des dépendances que l’on souhaite pouvoir installer pour le projet. Il se trouve à la racine, à côté de README.md et du dossier depenses, conformément à la structure convenue. Inscrivez une dépendance par ligne ; pour ce cours, le fichier contient la version utilisée de requests.

requests==2.32.3

Vous pouvez créer le fichier avec un éditeur de texte, puis vérifier la version réellement installée avant de la noter. La commande suivante affiche les informations du paquet dans l’environnement actif. Si vous installez une autre version que celle indiquée ici, inscrivez plutôt le numéro affiché afin que le fichier corresponde à l’installation effective.

python -m pip show requests

Name: requests
Version: 2.32.3
...

Vous pouvez aussi produire une liste des paquets installés avec python -m pip freeze. Cette commande est utile pour inventorier un environnement, mais elle peut inclure des paquets qui ne sont pas des dépendances directes du projet. Pour ce projet débutant, gardez un fichier lisible et limité aux dépendances nécessaires ; ajoutez une ligne lorsqu’un nouveau paquet externe devient nécessaire.

Sur une nouvelle machine ou dans un nouvel environnement virtuel, placez-vous à la racine du projet, activez l’environnement, puis installez la liste déclarée. pip résout alors les paquets requis et les installe dans l’environnement courant. Le fichier de dépendances peut être conservé avec le code du projet pour que les autres personnes retrouvent cette installation.

python -m pip install -r requirements.txt

Installation de requests==2.32.3 et des dépendances requises dans l’environnement actif.

Le paramètre -r indique à pip de lire les dépendances dans le fichier plutôt que de recevoir un nom de paquet directement. Après l’installation, vous pouvez vérifier que le paquet est disponible avec python -m pip show requests. Le fichier ne lance pas l’application et ne contient pas de code métier : il décrit uniquement ce qui doit être installé.

• Installez les paquets avec `python -m pip` après avoir activé l’environnement virtuel du projet.
• Épinglez la version d’une dépendance dans `requirements.txt` pour rendre son installation plus prévisible.
• Gardez dans ce fichier les paquets nécessaires au projet, sans confondre dépendances directes et inventaire complet de l’environnement.
• Réinstallez les dépendances sur un autre environnement avec `python -m pip install -r requirements.txt`.

Dans la prochaine leçon, vous répartirez le code du suivi de dépenses en modules et préparerez son point d’entrée.