====== PIP ======

  * Python Package Index (PyPi) : [[https://pypi.org/]]

===== Version =====

Afficher la version de pip :

<code bash>
pip -V
</code>

Mettre à jour pip :

<code bash>
pip install --upgrade pip
</code>

===== Configuration =====

Sous Windows, pour connaître l'emplacement du fichier de configuration de PIP :

<code bash>
pip config -v list

# exemple :
For variant 'global', will try loading 'C:\ProgramData\pip\pip.ini'
For variant 'user', will try loading 'C:\Users\toto\pip\pip.ini'
For variant 'user', will try loading 'C:\Users\toto\AppData\Roaming\pip\pip.ini'
For variant 'site', will try loading 'C:\Program Files\Python310\pip.ini'
</code>

Aucun de ces fichiers n'existait, j'ai donc créé
**C:\Users\toto\pip\pip.ini** et j'y ai mis ceci :

<code ini>
[global]
trusted-host =
    mirror1.example.com
    mirror2.example.com
</code>

===== Packages =====

Lister les packages installés :

<code bash>
pip list
</code>

Voir les infos sur un package installé :

<code bash>
pip show <nom-du-package>
</code>

Rechercher un package :

<code bash>
pip search <nom>
</code>

Installer un package :

<code bash>
pip install <nom-du-package>
</code>

S'il y a une erreur de vérification de certificat SSL (SSLCertVerificationError)

  * Soit ajouter les **trusted-host** dans le fichier de configuration
  * Soit les ajouter sur la ligne de commande, comme ci-dessous :

<code bash>
pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org <nom-du-package>
</code>

Dans un environnement virtuel, j'ai donc ajouté un fichier **pip.ini** dans le dossier **venv**
avec le contenu suivant :

<code ini>
[global]
trusted-host =
    pypi.org
    pypi.python.org
    files.pythonhosted.org
</code>

Désinstaller un package :

<code bash>
pip uninstall <nom-du-package>
</code>

Désinstaller un package et ses dépendances en même temps (voir [[https://pypi.org/project/pip-autoremove/]]) :

<code bash>
pip install pip-autoremove
pip-autoremove <nom-du-package>
</code>

Lister les packages qui peuvent être mis à jour :

<code bash>
pip list -o
</code>

Mettre à jour un package :

<code bash>
pip install <nom-du-package> -U
</code>

===== Requirements.txt =====

Créer un fichier **requirements.txt** correspondant aux packages installés dans
le Virtual Environment en cours :

<code bash>
source venv/bin/activate
(venv) pip freeze > requirements.txt
</code>

Ensuite pour réinstaller le tout dans un nouvel environnement, il suffit d'avoir
le fichier **requirements.txt** et de taper :

<code bash>
(venv) pip install -r requirements.txt
</code>

===== Mettre à jour tous les packages =====

Pour mettre à jour tous les packages de l'environnement virtuel,
il faut fournir à **pip** une liste des packages comportant
uniquement les noms, sans les numéros de versions.

La commande suivante coupe chaque ligne que renvoie **pip freeze** 
à chaque signe "=", afin de ne conserver que les noms :

<code bash>
(venv) pip freeze | cut -d'=' -f1
</code>

Il ne reste plus qu'à fournir cette liste à **pip install -U** et le tour
est joué :

<code bash>
(venv) pip freeze | cut -d'=' -f1 | xargs -n1 pip install -U
</code>

Ensuite si tout fonctionne correctement, on peut recréer un nouveau
fichier **requirements.txt**

<code bash>
(venv) pip freeze > requirements.txt
</code>

===== Erreur de certificat SSL =====

Source: [[https://stackoverflow.com/questions/25981703/pip-install-fails-with-connection-error-ssl-certificate-verify-failed-certi|StackOverflow]]

Dans le cas où une installation échoue à cause de **"CERTIFICATE_VERIFY_FAILED"**,
relancer la commande en indiquant les serveurs comme étant de confiance :

  * pypi.org
  * pypi.python.org
  * files.pythonhosted.org

<code bash>
pip install --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org nom_du_package
</code>

Et pour mettre à jour **pip** dans ces conditions :

<code bash>
pip install --upgrade --trusted-host pypi.org --trusted-host pypi.python.org --trusted-host files.pythonhosted.org pip setuptools
</code>