Python Rusz głową! Wydanie II

182

Rozdział 4.

Gotów do instalacji

Instalowanie pakietów za pomocą narzędzia pip

Teraz, gdy dysponujesz już swoim plikiem dystrybucji w postaci skompresowanego archiwum,

przyszedł czas na wykonanie kroku 3.:

Zainstaluj plik dystrybucji. Python upraszcza, jak wiele

innych kwestii, również tę czynność, zapewniając odpowiednie narzędzie. W przypadku Pythona

w wersji 3.4 (oraz nowszych) jest nim narzędzie

pip

, którego nazwa to skrót utworzony

z angielskich słów

P

ackage

I

nstaller for

P

ython (czyli instalator pakietów dla Pythona).

Krok 3. w systemie Windows

Znajdź swój nowo utworzony plik archiwum w folderze dist (przypomnij sobie, że plik nosi

nazwę

vsearch-1.0.tar.gz). Korzystając z okna Eksplorator plików, przytrzymaj klawisz Shift,

a następnie wywołaj menu kontekstowe za pomocą prawego przycisku myszy. Wybierz z niego

polecenie

Otwórz okno polecenia tutaj. Na ekranie pojawi się okno wiersza poleceń systemu

Windows. Używając go, wprowadź przedstawione poniżej polecenie, aby wykonać krok 3.

Utwórz opis

dystrybucji.

Wygeneruj plik

dystrybucji.

Zainstaluj plik

dystrybucji.

c:\Users\...\dist> py -3 -m pip install vsearch-1.0.tar.gz

Jeśli próba wykonania tego polecenia zakończy się niepowodzeniem i zgłoszony zostanie

błąd uprawnień, będziesz prawdopodobnie musiał ponownie uruchomić wiersz poleceń jako

administrator systemu

Windows, a następnie spróbować wykonać to polecenie raz jeszcze.

Jeśli wykonanie przedstawionego powyżej polecenia się powiedzie, na ekranie pojawią się

widoczne poniżej komunikaty.

Processing c:\users\...\dist\vsearch-1.0.tar.gz

Installing collected packages: vsearch

Running setup.py install for vsearch ... done

Successfully installed vsearch-1.0

Krok 3. w systemach uniksowych

W systemie Linux, Unix lub Mac OS X otwórz terminal w nowo utworzonym folderze dist,

a następnie wprowadź i zatwierdź polecenie, które zostało pokazane poniżej.

.../dist$ sudo python3 -m pip install vsearch-1.0.tar.gz

Jeśli wykonanie przedstawionego powyżej polecenia się powiedzie, na ekranie pojawią się

pokazane tutaj komunikaty.

Processing ./vsearch-1.0.tar.gz

Installing collected packages: vsearch

Running setup.py install for vsearch ... done

Successfully installed vsearch-1.0

Moduł vsearch jest teraz zainstalowany jako część pakietów.

Uruchom Pythona 3 z modułem

pip, po czym poproś ten moduł

o zainstalowanie podanego

pliku archiwum.

Sukces!

Sukces!

Używamy tu

polecenia sudo, aby

mieć pewność, że

instalujemy nasz

plik z odpowiednimi

uprawnieniami.

Uruchom Pythona 3

z modułem pip, po czym

poproś ten moduł

o zainstalowanie podanego

pliku archiwum.

jesteś tutaj�

183

Ponowne użycie kodu

Utwórz opis

dystrybucji.

Wygeneruj plik

dystrybucji.

Zainstaluj plik

dystrybucji.

Moduły: co już wiemy

Po zainstalowaniu naszego modułu

vsearch

możemy używać instrukcji

import vsearch

w każdym z naszych programów, mając pewność, że interpreter jest w stanie znaleźć

należące do modułu funkcje, których potrzebujemy.

Jeśli zdecydujemy się w jakimś momencie w przyszłości zmodyfikować kod naszego modułu,

będziemy mogli powtórzyć te trzy kroki, aby zainstalować wszystkie aktualizacje w pakietach.

Jeśli utworzysz nową wersję swojego modułu, pamiętaj, aby przypisać jej nowy numer wersji

w pliku setup.py.

Wszystko

zrobione!

CELNE SPOSTRZEŻENIA



Moduł to jedna funkcja lub większa ich liczba

zapisana w pliku.



Moduł można udostępniać, zapewniając, że

zawsze znajduje się w

bieżącym katalogu roboczym

interpretera (co da się zrobić, ale co nie jest dobrym

rozwiązaniem) albo w obrębie jego

lokalizacji

pakietów

(co jest znacznie lepszym pomysłem).



Wykonanie trzech kroków procedury związanej

z użyciem narzędzia setuptools zapewnia, że

moduł zostaje zainstalowany w pakietach, dzięki

czemu można go importować za pomocą instrukcji

import i korzystać z należących do niego funkcji

niezależnie od tego, jaki jest w danej chwili

bieżący

katalog roboczy

.

Każdy programista

Pythona również

może korzystać

z narzędzia pip,

aby zainstalować

Twój moduł.

Przekazywanie kodu dalej (znane również jako udostępnianie)

Gdy masz już utworzony plik dystrybucji, możesz go udostępnić innym programistom Pythona,

umożliwiając również im instalację Twojego modułu za pomocą narzędzia

pip

. Swój plik możesz

udostępniać w jeden z dwóch sposobów: nieformalnie lub formalnie.

Aby udostępnić swój moduł nieformalnie, po prostu rozdystrybuuj go w dowolny sposób, który

przyjdzie Ci do głowy, i wśród wszystkich tych osób, którym będziesz go chciał przekazać (na przykład

wysyłając plik pocztą elektroniczną, zapisując w pamięci przenośnej USB lub udostępniając do

ściągnięcia na Twojej osobistej stronie internetowej). Naprawdę możesz to zrobić, jeśli tylko zechcesz.

Aby udostępnić swój moduł formalnie, możesz wrzucić plik dystrybucji do centralnie zarządzanego,

dostępnego poprzez sieć repozytorium kodu, które nosi nazwę PyPI (co jest skrótem od angielskich

słów

Python Package Index, oznaczających indeks pakietów Pythona). Celem istnienia tego serwisu

jest umożliwienie wszystkim programistom Pythona udostępnianie wszelkiej maści modułów

pochodzących od osób trzecich. Więcej informacji na temat tego, co PyPI ma do zaoferowania,

znajdziesz pod adresem

https://pypi.python.org/pypi

. Dodatkowe dane o procedurze wrzucania

i udostępniania plików dystrybucji za pośrednictwem PyPI opublikowano w dostępnym online

przewodniku opracowanym przez

Python Packaging Authority, który można znaleźć pod adresem

https://www.pypa.io

. (W gruncie rzeczy nie ma tu wiele więcej do powiedzenia, ale i te szczegóły

wykraczają poza materiał prezentowany w tej książce).

Dotarliśmy już niemal do końca naszego wprowadzenia do funkcji i modułów. Jest jeszcze tylko

jedna mała zagadka, która wymaga naszej uwagi (przez nie więcej niż pięć minut). Jeśli będziesz

gotów, przejdź do następnej strony.