ensurepip — Amorçage de l'installateur pip

Nouveau dans la version 3.4.

Source code: Lib/ensurepip

Le module ensurepip met en place l'installateur pip dans un environnement Python, classique ou virtuel. Ce principe d'amorçage a été choisi car pip est un projet séparé de Python avec son propre cycle de versions. Il permet en particulier d'embarquer la version la plus récente de pip dans les mises à jour de maintenance de l'interpréteur CPython comme dans les nouvelles versions principales.

Dans la plupart des cas, il n'est pas nécessaire de recourir à ce module. pip est le plus souvent déjà installé pour vous. Cependant, ensurepip peut s'avérer utile si l'installation de pip a été sautée au moment de l'installation de Python (ou en créant un environnement virtuel), ou bien si pip a été désinstallé par l'utilisateur.

Note

Ce module n'accède pas au réseau. Tout ce qu'il faut pour amorcer pip est compris dans le paquet.

Voir aussi

Installation de modules Python

Guide de l'utilisateur final pour installer des paquets Python

PEP 453 : Amorçage explicite de pip dans les installations de Python

Les motivations pour l'ajout de ce module et sa spécification d'origine

Availability: not Emscripten, not WASI.

This module does not work or is not available on WebAssembly platforms wasm32-emscripten and wasm32-wasi. See Plateformes WebAssembly for more information.

Interface en ligne de commande

On fait appel à l'interface en ligne de commande à l'aide de l'option -m de l'interpréteur.

L'invocation la plus simple est :

python -m ensurepip

Cette commande installe pip s'il n'est pas déjà présent. Sinon, elle ne fait rien. Pour s'assurer que la version de pip est au moins aussi récente que celle embarquée dans ensurepip, passer l'option --upgrade :

python -m ensurepip --upgrade

pip est installé par défaut dans l'environnement virtuel courant, s'il y en a un, ou bien dans le dossier site-packages du système. L'emplacement d'installation se règle à travers deux options :

  • --root dir: Installs pip relative to the given root directory rather than the root of the currently active virtual environment (if any) or the default root for the current Python installation.

  • --user : installe pip dans le dossier site-packages propre à l'utilisateur au lieu du dossier global de l'installation de Python. Cette option n'est pas valide dans un environnement virtuel.

Par défaut, les commandes pipX et pipX.Y sont créées (où X.Y est la version de Python avec laquelle ensurepip est utilisé). Cela se contrôle par deux options supplémentaires :

  • --altinstall : dans ce mode d'« installation parallèle », seule la commande pipX.Y est ajoutée, et pas la commande pipX.

  • --default-pip : ce mode d'« installation de la version par défaut » crée la commande pip en plus de pipX et pipX.Y.

Combiner ces deux options conduit à une exception.

API du module

Le module ensurepip définit deux fonctions pour utilisation dans les programmes :

ensurepip.version()

Renvoie, sous forme de chaîne, la version de pip qui serait installée par ensurepip.

ensurepip.bootstrap(root=None, upgrade=False, user=False, altinstall=False, default_pip=False, verbosity=0)

Amorce pip dans l'environnement courant ou un environnement spécifique.

Passer root permet de changer la racine du chemin d'installation. Si root vaut None (la valeur par défaut), l'installation se fait dans la racine par défaut pour l'environnement courant.

upgrade indique s'il faut ou non effectuer la mise à jour d'une éventuelle version plus ancienne de pip déjà installée vers la version embarquée dans ensurepip.

Si user vaut vrai, pip est mis dans des chemins qui le rendent disponible pour cet utilisateur uniquement, et non pour tous les utilisateurs de l'installation de Python.

Par défaut, les commandes créées sont pipX et pipX.Y (où X.Y est la version de Python).

Si altinstall vaut vrai, pipX n'est pas créée.

Si default_pip vaut vrai, la commande pip est créée en plus des deux autres.

Le fait de combiner altinstall et default_pip lève l'exception ValueError.

verbosity règle le niveau de verbosité des messages émis sur sys.stdout pendant l'amorçage.

Cette fonction lève un événement d'audit ensurepip.bootstrap avec l'argument root.

Note

Le processus d'amorçage a des effets de bord sur sys.path et os.environ. Pour les éviter, on peut appeler l'interface en ligne de commande dans un sous-processus.

Note

L'amorçage peut installer des modules supplémentaires qui sont requis pour pip. Les autres programmes ne doivent pas prendre pour acquise la présence de ces modules, car pip pourrait dans une version future se passer de ces dépendances.