Pip

pip
Käsu pip --help väljund
Autor	Ian Bicking
Viimane väljalase	24.0 / 3.02.2024
Kirjutatud keeles	Python
Litsents	MIT
Veebisait	https://pip.pypa.io/en/stable/

pip on Pythonis kirjutatud paketihaldur Pythoni pakettide jaoks. pip-iga paigaldatakse Pythoni pakette. Pip tuleb Pythoniga vaikimisi kaasa alatest Pythoni 3.4 versioonist. Pip hangib pakette kas kohaliku failisüsteemi kaustadest või repositooriumitest, mis vastavad PEP 503 lihtsa repositooriumi rakendusliidesele. Vaikimisi kasutatakse PyPI repositooriumi. Pip on siiani enimkasutatud Pythoni paketihaldur.

Ajalugu

2008 tutvustas Ian Bicking (virtualenv paketi looja) paketihaldurit nimega pyinstall alternatiiviks olemasolevale paketihaldurile easy install. Tutvustavas blogipostitusele tulnud soovituste hulgast valiti pyinstalli uueks nimeks pip. Bickingu seletas selle nime lahti rekursiivse akronüümina "Pip Installs Packages". Aastal 2011 loodi organisatsioon Python Packaging Authority (PyPA), mis võttis üle pip ja virtualenv haldamise Bickingult. pip versiooniga 6.0 12.22.2014 muudeti pip versioonide nimekuju, eemaldades number 1 versiooninumbrist.

Käsurealiides

Pip'i käsurealiideselt Pythoni paketi paigalstamiseks kasuta käsku: pip install paketi-nimi

Paketi eemaldamiseks kasutades käsku: pip uninstall paketi-nimi

Pip saab hallata korraga tervet nimekirja pakettidest kasutades "requirements" faili. Requirements kirjeldab pakette ning nende versioone ning kasutades pipi saab kõik vajalikud paketid paigaldada korrektsete versioonidega näiteks teise arvutisse või virtuaalsesse keskkonda.

Requirements.txt failis kirjeldatud pakettide paigaldamiseks käsurealt kasuta käsku pip install -r requirements.txt.

Pip paketi struktuur

Ise pip-iga paigaldatava paketi loomiseks tuleb kasutada ettenähtud struktuuri:

example_project/
├── exampleproject/      Pythoni paketi lähtekood
|    ├── __init__.py    
|    └── example.py
├── setup.py             pip-i paketti kirjeldav python
└── README.md            Tekstifail, mis kirjeldab projekti

Setup.py sisu on järgmine

from setuptools import setup, find_packages

setup(
    name='example',  # Paketi nimi. Seda kasutatakse, kui projekt imporditakse paketina.
    version='0.1.0',
    packages=find_packages(include=['exampleproject', 'exampleproject.*'])  # Pip installib automaatselt kõik siin välja toodud sõltuvused.
)

Kui see on tehtud, siis loodud paketi paigaldamiseks projekti juurkaustas kasutada järgnevat käsku: pip install -e.

Muude repositooriumite kasutamine

Peale vaikimi määratud PyPI repositooriumi on võimalik pip-ga kasutada ka muid repositoorime. Selleks võib olla kas HTTP(S) URL või faili asukoht failisüsteemis.

Kasutamaks mõnda muud repositooriumit on vaja käsureal -i või -index-url parameetrit: pip install -i https://sinu-muu-repositoorium/simple <paketi nimi>; või kui kasutada failisüsteemi: pip install -i /tee/sinu/muu/repositooriumini/simple <paketi nimi>.

Vaata ka

• Setuptools
• Pipenv
• Python Poetry
• Conda (package manager)
• PyPM - ActiveState'