Utilizarea pip pentru instalare
pip este programul de instalare recomandat. Mai jos, vom acoperi cele mai comune scenarii de utilizare. Pentru mai multe detalii, consultați documentele pip, care include un Ghid de referință complet.
Instalarea din PyPI
Cea mai obișnuită utilizare a pip este instalarea din Python Package Index folosind un specificator de cerințe. În general, un specificator de cerințe este compus dintr-un nume de proiect urmat de un specificator de versiune opțional. PEP 440 conține o specificație completă a specificatoarelor acceptate în prezent. Mai jos sunt câteva exemple.
Pentru a instala cea mai recentă versiune a „SomeProject”:
py -m pip install "SomeProject"
Pentru a instala o anumită versiune:
py -m pip install "SomeProject==1.4"
Pentru a instala o versiune mai mare sau egală cu o versiune și mai mică decât alta:
py -m pip install "SomeProject>=1,<2"
Pentru a instala o versiune „compatibilă” cu o anumită versiune: (1)
py -m pip install "SomeProject~=1.4.2"
În acest caz, aceasta înseamnă să instalați orice versiune „== 1.4.*” Care este și „>=1.4.2”.
Distribuții sursă vs Wheels
pip se poate instala fie din Source Distributions (sdist), fie din Wheels, dar dacă ambele sunt prezente pe PyPI, pip va prefera Wheels compatibil. Puteți suprascrie comportamentul implicit al pip-ului, de ex. folosind opțiunea sa –no-binary.
Wheels sunt un format de distribuție pre-construit, care oferă o instalare mai rapidă în comparație cu distribuțiile sursă (sdist), mai ales atunci când un proiect conține extensii compilate.
Dacă pip nu găsește Wheels instalat, va construi local Wheels și o va memora în cache pentru instalările viitoare, în loc să reconstruiască distribuția sursă în viitor.
Actualizarea pachetelor
Actualizați un SomeProject deja instalat la cel mai recent din PyPI.
py -m pip install --upgrade SomeProject
Instalarea pe site-ul utilizatorului
Pentru a instala pachete izolate de utilizatorul curent, utilizați semnalizatorul
:
--user
py -m pip install --user SomeProject
Pentru mai multe informații, consultați secțiunea Instalări utilizator din documentele pip.
--user
nu are efect atunci când se află într-un mediu virtual – toate comenzile de instalare vor afecta mediul virtual.
Dacă SomeProject
definește orice script de linie de comandă sau puncte de intrare în consolă,
le va face să fie instalate în directorul binar al bazei de utilizatori, care poate fi sau nu deja prezent în
--userPATH
-ul shell-ului. (Începând cu versiunea 10, pip afișează un avertisment la instalarea oricărui script într-un director în afara PATH
.) Dacă scripturile nu sunt disponibile în shell după instalare, va trebui să adăugați directorul la PATH
:
- Pe Linux și macOS puteți găsi directorul binar de bază de utilizatori rulând
python -m site --user-base
și adăugândbin
la final. De exemplu, acest lucru va tipări~/.local
(cu~
extins la calea absolută către directorul dvs. home), așa că va trebui să adăugați~/.local/bin
laPATH
. Puteți setaPATH
-ul dvs. permanent modificând ~/.profile. - Pe Windows puteți găsi directorul binar de bază de utilizatori rulând
py -m site --user-site
și înlocuindsite-packages
cuScripts
. De exemplu, acest lucru ar putea returnaC:\Users\Username\AppData\Roaming\Python36\site-packages
, așa că va trebui să setațiPATH
-ul dvs. pentru a includeC:\Users\Username\AppData\Roaming\Python36\Scripts
. Puteți setaPATH
-ul utilizatorului permanent în Panoul de control. Poate fi necesar să vă deconectați pentru ca modificărilePATH
să aibă efect.
Fișiere cu cerințe
Instalați o listă de cerințe specificate într-un fișier de cerințe.
py -m pip install -r requirements.txt
Instalarea din VCS
Instalați un proiect din VCS în modul „editable”. Pentru o defalcare completă a sintaxei, consultați secțiunea pip despre asistența VCS.
py -m pip install -e git+https://git.repo/some_pkg.git#egg=SomeProject # from git
py -m pip install -e hg+https://hg.repo/some_pkg#egg=SomeProject # from mercurial
py -m pip install -e svn+svn://svn.repo/some_pkg/trunk/#egg=SomeProject # from svn
py -m pip install -e git+https://git.repo/some_pkg.git@feature#egg=SomeProject # from a branch
Instalarea din alte indexuri
Instalați dintr-un index alternativ
py -m pip install --index-url http://my.package.repo/simple/ SomeProject
Căutați un index suplimentar în timpul instalării, pe lângă PyPI
py -m pip install --extra-index-url http://my.package.repo/simple SomeProject
Instalarea dintr-un arbore src local
Instalarea de la src local în modul dezvoltare, adică în așa fel încât proiectul pare să fie instalat, dar totuși să fie încă editabil din arborele src.
py -m pip install -e <path>
De asemenea, puteți instala în mod normal de la src
py -m pip install <path>
Instalarea din arhive locale
Instalați un anumit fișier de arhiva sursă.
py -m pip install ./downloads/SomeProject-1.0.4.tar.gz
Instalați dintr-un director local care conține arhive (și nu verificați PyPI)
py -m pip install --no-index --find-links=file:///local/dir/ SomeProject
py -m pip install --no-index --find-links=/local/dir/ SomeProject
py -m pip install --no-index --find-links=relative/dir/ SomeProject
Instalarea din alte surse
Pentru a instala din alte surse de date (de exemplu, stocarea Amazon S3) puteți crea o aplicație de asistență care prezintă datele într-un format de index compatibil PEP 503 și puteți utiliza semnalizatorul --extra-index-url
pentru a direcționa pip să utilizeze acel index.
./s3helper --port=7777
python -m pip install --extra-index-url http://localhost:7777 SomeProject
Instalarea prelansărilor
Găsiți versiuni de pre-lansare și dezvoltare, pe lângă versiuni stabile. În mod implicit, pip găsește doar versiuni stabile.
py -m pip install --pre SomeProject
Instalarea Setuptools „Extras”
Instalați extras setuptools.
py -m pip install SomePackage[PDF]
py -m pip install SomePackage[PDF]==3.0
py -m pip install -e .[PDF]==3.0 # editable project in current directory
Note
(1) Specificatorul de versiune compatibil a fost acceptat în PEP 440 și suportul a fost lansat în setuptools v8.0 și pip v6.0
Sursa: Installing Packages, sub licența Python Software Foundation License Version 2. Copyright Python Software Foundation; All Rights Reserved. Traducere și adaptare de Nicolae Sfetcu
Lasă un răspuns