{{tag>dev python paquetage bibliotheque package library}}


====== Gestion des bibliothèques avec pip ======

Les nombreuses bibliothèques Python sont centralisées et accessibles sur un dépôt en ligne répondant au doux nom de **PyPI** (**Py**thon **P**ackage **I**ndex). Les opérations de téléchargement, d'installation, de mises à jour ou de suppression des bibliothèques se font via l'outil **pip** (**P**ython **I**nstalls **P**ackages ou Preferred Installer Program).

===== Installation en environnement virtuel =====

Depuis la version 3.3, Python intègre la gestion des environnements virtuels. Chaque environnement peut ainsi avoir son jeu de bibliothèques indépendant de celui du système hôte.

===== Installation de pip =====

**pip** est inclus dans les versions les plus récentes de Python:
  * Python 2.7.9 ou supérieures,
  * Python 3.4 ou supérieures.

Pour le version antérieures, sous Ubuntu
<code bash>
$ sudo apt-get install python-pip
</code>

Pour Windows, télécharger le script disponible a l'une des l'URLs ci dessous:
  * https://bootstrap.pypa.io/get-pip.py
  * https://bootstrap.pypa.io/3.2/get-pip.py

Ouvrir une console et exécuter le script:

<code>
c:\path\to\script> python get-pip.py
</code>



===== Rechercher une bibliothèque =====

<code bash>
pip search "keywords"
</code>

===== afficher des infos =====

<code bash>
pip show package-name
</code>

===== Installer une bibliothèque =====

Invoquer pip avec l'argument install

<code bash>
$ pip install package-name
</code>

Il est possible de préciser la version:
<code bash>
$ pip install package-name==1.0.1
</code>

===== Lister les bibliothèques installées =====

<code bash>
$ pip list
$ pip freeze
</code>

===== Mise à jour =====

Lister les bibliothèques obsolètes:
<code bash>
$ pip list --outdated
</code>

Mettre à jour ou forcer une réinstallation:

<code bash>
$ pip install package-name --upgrade
$ pip install package-name --upgrade --force-reinstall
</code>

===== Supprimer une bibliothèque =====

Pour désinstaller un paquetage:

<code bash>
$ pip uninstall package-name
</code>



===== Reconstruire les dépendances =====

Enregistrer dans un fichier la liste des bibliothèques installées localement ou disponibles dans l'environnement virtuel:

<code bash>
$ pip freeze > packages-requis.txt
</code>

Cette liste pourra être passées en paramètre à pip pour réinstaller les bibliothèques indispensables à l’exécution du script:

<code bash>
$ pip install -r packages-requis.txt
</code>


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

  * https://www.makeuseof.com/tag/install-pip-for-python/
  * https://stackoverflow.com/questions/6600878/find-all-packages-installed-with-easy-install-pip#6600907
  * https://pip.pypa.io/en/stable/reference/pip_freeze/#pip-freeze