ensurepip — Bootstrapping the pip installer

Hinzugefügt in Version 3.4.

Source code: Lib/ensurepip

Das Paket ensurepip bietet Unterstützung für das Bootstrapping des pip-Installers in eine bestehende Python-Installation oder eine virtuelle Umgebung. Dieser Bootstrapping-Ansatz spiegelt die Tatsache wider, dass pip ein unabhängiges Projekt mit eigenem Release-Zyklus ist und die neueste verfügbare stabile Version mit Wartungs- und Feature-Releases des CPython-Referenzinterpreters gebündelt wird.

In den meisten Fällen müssen Endbenutzer von Python dieses Modul nicht direkt aufrufen (da pip standardmäßig gebootstrappt werden sollte), es kann jedoch erforderlich sein, wenn die Installation von pip bei der Installation von Python (oder beim Erstellen einer virtuellen Umgebung) übersprungen wurde oder nach der expliziten Deinstallation von pip.

Hinweis

Dieses Modul greift *nicht* auf das Internet zu. Alle Komponenten, die zum Bootstrapping von pip benötigt werden, sind als interne Teile des Pakets enthalten.

Siehe auch

Python-Module installieren

Der Leitfaden für Endbenutzer zur Installation von Python-Paketen

PEP 453: Explizites Bootstrapping von pip in Python-Installationen

Die ursprüngliche Begründung und Spezifikation für dieses Modul.

Verfügbarkeit: nicht Android, nicht iOS, nicht WASI.

Dieses Modul wird auf mobilen Plattformen oder WebAssembly-Plattformen nicht unterstützt.

Befehlszeilenschnittstelle

Die Befehlszeilenschnittstelle wird über den Schalter -m des Interpreters aufgerufen.

Die einfachste mögliche Aufrufung ist

python -m ensurepip

Diese Aufrufung installiert pip, falls es noch nicht installiert ist, tut aber ansonsten nichts. Um sicherzustellen, dass die installierte Version von pip mindestens so aktuell ist wie die in ensurepip verfügbare, übergeben Sie die Option --upgrade.

python -m ensurepip --upgrade

Standardmäßig wird pip in die aktuelle virtuelle Umgebung (falls eine aktiv ist) oder in die System-Site-Packages (falls keine virtuelle Umgebung aktiv ist) installiert. Der Installationsort kann über zwei zusätzliche Befehlszeilenoptionen gesteuert werden.

--root <dir>

Installiert pip relativ zum angegebenen Stammverzeichnis anstelle des Stamms der aktuell aktiven virtuellen Umgebung (falls vorhanden) oder des Standardstamms für die aktuelle Python-Installation.

--user

Installiert pip im Benutzer-Site-Packages-Verzeichnis anstatt global für die aktuelle Python-Installation (diese Option ist in einer aktiven virtuellen Umgebung nicht zulässig).

Standardmäßig werden die Skripte pipX und pipX.Y installiert (wobei X.Y für die Version von Python steht, die zum Aufrufen von ensurepip verwendet wird). Die installierten Skripte können über zwei zusätzliche Befehlszeilenoptionen gesteuert werden.

--altinstall

Wenn eine alternative Installation angefordert wird, wird das Skript pipX *nicht* installiert.

--default-pip

Wenn eine „default pip“-Installation angefordert wird, wird das Skript pip zusätzlich zu den beiden regulären Skripten installiert.

Die Angabe beider Optionen zur Skriptauswahl löst eine Ausnahme aus.

Modul-API

ensurepip stellt zwei Funktionen für die programmatische Verwendung bereit.

ensurepip.version()

Gibt eine Zeichenkette zurück, die die verfügbare Version von pip angibt, die bei der Bootstrappung einer Umgebung installiert wird.

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

Bootstrappt pip in die aktuelle oder designierte Umgebung.

root gibt ein alternatives Stammverzeichnis an, relativ zu dem installiert werden soll. Wenn root None ist, verwendet die Installation den Standardinstallationsort für die aktuelle Umgebung.

upgrade gibt an, ob eine vorhandene Installation einer früheren Version von pip auf die verfügbare Version aktualisiert werden soll.

user gibt an, ob das Benutzerschema verwendet werden soll, anstatt global zu installieren.

Standardmäßig werden die Skripte pipX und pipX.Y installiert (wobei X.Y für die aktuelle Python-Version steht).

Wenn altinstall gesetzt ist, wird das Skript pipX *nicht* installiert.

Wenn default_pip gesetzt ist, wird das Skript pip zusätzlich zu den beiden regulären Skripten installiert.

Das Setzen von sowohl altinstall als auch default_pip löst einen ValueError aus.

verbosity steuert die Ausführlichkeit der Ausgabe nach sys.stdout während des Bootstrapping-Vorgangs.

Löst ein Audit-Ereignis ensurepip.bootstrap mit dem Argument root aus.

Hinweis

Der Bootstrapping-Prozess hat Nebeneffekte sowohl auf sys.path als auch auf os.environ. Das Aufrufen der Befehlszeilenschnittstelle in einem Unterprozess ermöglicht es, diese Nebeneffekte zu vermeiden.

Hinweis

Der Bootstrapping-Prozess kann zusätzliche Module installieren, die von pip benötigt werden, aber andere Software sollte nicht davon ausgehen, dass diese Abhängigkeiten immer standardmäßig vorhanden sein werden (da die Abhängigkeiten in einer zukünftigen Version von pip entfernt werden können).