Utilisation du gestionnaire de paquets pip

Qu'est-ce que pip ? Installation et concepts de base

pip est le gestionnaire de paquets standard pour Python. Il permet d'installer, de mettre à jour et de gérer les bibliothèques et les dépendances de vos projets Python. pip est l'acronyme récursif de "Pip Installs Packages".

pip est généralement inclus par défaut avec les versions récentes de Python (depuis Python 3.4 pour les versions standard et depuis Python 2.7.9 pour Python 2). Pour vérifier si pip est installé, ouvrez un terminal et tapez la commande :

pip --version

ou :

pip3 --version

Si pip n'est pas installé, vous pouvez l'installer en suivant les instructions sur le site officiel de la Python Packaging Authority (PyPA) : pypa.io/en/latest/installing/

pip utilise le Python Package Index (PyPI) comme source principale de paquets. PyPI est un dépôt centralisé qui contient des milliers de bibliothèques Python open source.

Installer des paquets avec pip : commandes de base

Pour installer un paquet avec pip, utilisez la commande `pip install` suivie du nom du paquet. Par exemple, pour installer la bibliothèque `requests`, qui permet d'effectuer des requêtes HTTP, tapez :

pip install requests

Il est fortement recommandé d'installer les paquets dans un environnement virtuel plutôt que globalement sur votre système. Cela permet d'éviter les conflits de versions entre les différents projets.

Vous pouvez installer plusieurs paquets en une seule commande :

pip install requests beautifulsoup4

Pour installer une version spécifique d'un paquet, utilisez l'opérateur `==` :

pip install requests==2.28.2

Vous pouvez également spécifier une plage de versions acceptables :

pip install requests>=2.20.0,<2.29.0

Pour installer un paquet à partir d'un fichier local (par exemple, un fichier `.tar.gz` ou `.whl`), utilisez la commande `pip install` suivie du chemin vers le fichier :

pip install /chemin/vers/mon_paquet.tar.gz

Pour installer un package depuis un dépôt Git :

pip install git+https://github.com/utilisateur/mon_projet.git

Gérer les dépendances avec requirements.txt : bonnes pratiques

Pour gérer les dépendances de vos projets de manière reproductible, il est recommandé d'utiliser un fichier `requirements.txt`. Ce fichier liste tous les paquets nécessaires à votre projet, avec leurs versions exactes.

Vous pouvez générer automatiquement un fichier `requirements.txt` à partir des paquets installés dans votre environnement virtuel en utilisant la commande :

pip freeze > requirements.txt

Cette commande crée un fichier `requirements.txt` qui contient la liste des paquets installés et leurs versions, par exemple :

requests==2.28.2
beautifulsoup4==4.12.2

Pour installer les dépendances à partir d'un fichier `requirements.txt`, utilisez la commande :

pip install -r requirements.txt

Il est recommandé d'inclure le fichier `requirements.txt` dans le répertoire racine de votre projet et de le versionner avec votre code source (par exemple, avec Git). Cela permet à d'autres développeurs (ou à vous-même, sur une autre machine) d'installer facilement les mêmes dépendances et de reproduire votre environnement de développement.

Il est aussi possible d'utiliser des commentaires dans un fichier `requirements.txt`. Ils doivent se trouver seuls sur leur ligne et commencer par le caractère `#`.

Mettre à jour et désinstaller des paquets : commandes utiles

Pour mettre à jour un paquet à la dernière version disponible, utilisez la commande `pip install --upgrade` (ou `-U` en version courte) suivie du nom du paquet :

pip install -U requests

Pour lister les paquets obsolètes (c'est-à-dire les paquets pour lesquels une version plus récente est disponible), utilisez la commande :

pip list --outdated

Pour désinstaller un paquet, utilisez la commande `pip uninstall` suivie du nom du paquet :

pip uninstall requests

pip vous demandera confirmation avant de désinstaller le paquet.

Pour afficher des informations sur un paquet installé (version, auteur, description, dépendances, etc.), utilisez la commande `pip show` suivie du nom du paquet :

pip show requests

pip et les wheels : optimiser l'installation des paquets

Les wheels sont un format de distribution binaire pour Python qui permet d'installer des paquets plus rapidement et plus facilement, en particulier les paquets qui contiennent du code compilé (comme NumPy ou SciPy). Un wheel est un fichier `.whl` qui contient le code pré-compilé du paquet, ainsi que des métadonnées.

Lorsque vous installez un paquet avec pip, pip vérifie d'abord si un wheel compatible avec votre système et votre version de Python est disponible sur PyPI. Si c'est le cas, pip télécharge et installe le wheel, ce qui est beaucoup plus rapide que de télécharger le code source et de le compiler.

Vous n'avez généralement rien à faire de spécial pour utiliser les wheels, pip les utilise automatiquement lorsqu'ils sont disponibles. Cependant, vous pouvez forcer pip à n'utiliser que les wheels en utilisant l'option `--only-binary :all:` :

pip install --only-binary :all: requests

Inversement, si un package ne fonctionne pas correctement et que vous souhaitez forcer son installation à partir des sources, vous pouvez utiliser l'option `--no-binary` de la façon suivante :

pip install --no-binary :all: requests