{{tag>dev python pip}}

====== pip ======

pip est un outil de gestion des bibliothèques externes Python. Il permet:
  * Installer les bibliothèques et les dépendances.
  * Mettre à jour/downgrader les versions.
  * Facilite le déploiement d'une application en générant un listing des bibliothèques utilisées et leurs versions


<code bash>
$ sudo apt-get install python-pip
</code>

Installation de la bibliothèque pourra se faire pour l'ensemble du système ou simplement pour l'utilisateur courant:

===== Mise à jour de pip =====

Si des erreurs sont retournées par les commandes pip, il est possible de le remettre à jour:
<code bash>
python3 -m pip install --upgrade pip
</code>

Vérifier également l'installation et les versions des paquets **setuptools** et **wheel**

===== Rechercher un paquet =====

<code bash>
$ pip search docker-compose
</code>

===== Installer un paquet =====

<code bash>
$ sudo pip install --user bottle
</code>


===== Générer un bundle =====

La commande freeze permet de lister toutes les bibliothèques et leur version, la sortie de la commande peut être redirigée dans un fichier puis réutilisée pour un déploiement de l'application.

<code bash>
$ pip freeze > libs.txt
</code>

Pour installer les bibliothèques:
<code bash>
$ pip install -r libs.txt
</code>

Toujours grâce à ce fichier de listing, il est possible de générer une archive contenant l'ensemble des dépendances pour une installation hors ligne:

<code bash>
$ pip bundle myLibs.pybundle -r libs.txt
</code>

===== Installer un bundle =====

Pour installer le bundle sur la machine cible:

<code bash>
$ pip install myLibs.pybundle
</code>

===== Gérer les versions =====

Liste les paquets installés et leur version:

<code bash>
$ pip list
</code>

Pour lister les différentes versions disponibles d'un même paquet dans le cas de pip >= 9.0
<code bash>
$ pip install docker-compose==
</code>

Pour les version antérieures de pip, donner en argument une version inexistante
<code bash>
$ pip install docker-compose==toto
</code>

Pour spécifier des critères sur les versions

<code bash>
$ pip install --user docker-compose==1.8.1 
</code>

===== Troubleshooting / dépannage =====

Lors de l'utilisation de **pip3 search**, un message d'erreur est retourné:
<code>
ERROR: XMLRPC request failed [code: -32500]
RuntimeError: PyPI's XMLRPC API is currently disabled due to unmanageable load and will be deprecated in the near future. See https://status.python.org/ for more information.
</code>

Ce mode de recherche de paquetages est désactivé suite a de trop nombreuses requêtes. Utiliser l'interface web https://pypi.org/

source: https://softbranchdevelopers.com/why-does-pip-search-lead-to-an-error-xmlrpc-request-failed/

===== Références =====

  * http://sametmax.com/votre-python-aime-les-pip/
  * https://stackoverflow.com/questions/4888027/python-and-pip-list-all-versions-of-a-package-thats-available#26664162