ensurepip — Bootstrapping för för pip-installeraren

Tillagd i version 3.4.

Källkod: Lib/ensurepip

Paketet ensurepip ger stöd för att starta upp installationsprogrammet för pip i en befintlig Python-installation eller virtuell miljö. Denna uppstartsmetod återspeglar det faktum att pip är ett oberoende projekt med sin egen utgivningscykel, och den senaste tillgängliga stabila versionen levereras med underhålls- och funktionsutgåvor av CPython-referenstolken.

I de flesta fall bör slutanvändare av Python inte behöva anropa denna modul direkt (eftersom pip bör startas upp som standard), men det kan behövas om installationen av pip hoppades över när Python installerades (eller när en virtuell miljö skapades) eller efter att pip uttryckligen avinstallerats.

Anteckning

Denna modul har inte tillgång till internet. Alla komponenter som behövs för att starta upp pip ingår som interna delar av paketet.

Se även

Installera Python-moduler

Slutanvändarhandboken för installation av Python-paket

PEP 453: Explicit bootstrapping av pip i Python-installationer

Den ursprungliga motiveringen och specifikationen för denna modul.

Tillgänglighet: not Android, not iOS, not WASI.

Denna modul stöds inte på mobile platforms eller WebAssembly platforms.

Kommandoradsgränssnitt

Kommandoradsgränssnittet anropas med hjälp av tolkens -m-switch.

Den enklaste möjliga anropet är:

python -m ensurepip

Detta anrop kommer att installera pip om det inte redan är installerat, men gör annars ingenting. För att säkerställa att den installerade versionen av pip är minst lika ny som den som finns tillgänglig i ensurepip, skicka alternativet --upgrade:

python -m ensurepip --upgrade

Som standard installeras pip i den aktuella virtuella miljön (om en sådan är aktiv) eller i systempaketet (om det inte finns någon aktiv virtuell miljö). Installationsplatsen kan styras med hjälp av ytterligare två kommandoradsalternativ:

--root <dir>

Installerar pip i förhållande till den angivna rotkatalogen i stället för roten till den aktiva virtuella miljön (om någon) eller standardroten för den aktuella Python-installationen.

--user

Installerar pip i katalogen för användarwebbplatsens paket i stället för globalt för den aktuella Python-installationen (detta alternativ är inte tillåtet i en aktiv virtuell miljö).

Som standard kommer skripten pipX och pipX.Y att installeras (där X.Y står för den version av Python som används för att anropa ensurepip). De skript som installeras kan styras med hjälp av ytterligare två kommandoradsalternativ:

--altinstall

Om en alternativ installation begärs kommer skriptet pipX inte att installeras.

--default-pip

Om en ”default pip”-installation begärs kommer skriptet pip att installeras utöver de två vanliga skripten.

Om du anger båda alternativen för skriptval kommer ett undantag att utlösas.

Modul API

ensurepip exponerar två funktioner för programmatisk användning:

ensurepip.version()

Returnerar en sträng som anger den tillgängliga versionen av pip som ska installeras när en miljö startas upp.

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

Bootstrappar pip till den aktuella eller angivna miljön.

root anger en alternativ rotkatalog att installera i förhållande till. Om root är None använder installationen standardinstallationsplatsen för den aktuella miljön.

upgrade anger om en befintlig installation av en tidigare version av pip ska uppgraderas till den tillgängliga versionen eller inte.

user anger om användarsystemet ska användas i stället för att installera globalt.

Som standard kommer skripten pipX och pipX.Y att installeras (där X.Y står för den aktuella versionen av Python).

Om altinstall är inställt kommer pipX inte att installeras.

Om default_pip är inställt kommer pip att installeras utöver de två vanliga skripten.

Att ställa in både altinstall och default_pip kommer att utlösa ValueError.

verbosity styr nivån på utdata till sys.stdout från bootstrapping-operationen.

Utlöser en auditing event ensurepip.bootstrap med argument root.

Anteckning

Bootstrapping-processen har bieffekter på både sys.path och os.environ. Genom att istället anropa kommandoradsgränssnittet i en underprocess kan dessa bieffekter undvikas.

Anteckning

Bootstrapping-processen kan installera ytterligare moduler som krävs av pip, men annan programvara bör inte förutsätta att dessa beroenden alltid kommer att finnas som standard (eftersom beroendena kan tas bort i en framtida version av pip).