Python Rusz głową! Wydanie II

180

Rozdział 4.

Konfiguracja w systemie Windows

Tworzenie pliku dystrybucji

Na tym etapie powinieneś mieć trzy pliki, które znajdują się w naszym folderze o nazwie

mymodules. Są to: vsearch.py, setup.py oraz README.txt.

Teraz jesteśmy gotowi, aby z tych trzech plików utworzyć pakiet dystrybucyjny. Jest

to krok 2. naszej wcześniejszej listy:

Wygeneruj plik dystrybucji. Zrobimy to z poziomu

systemowego wiersza poleceń. Choć sama operacja jest dość prosta, trzeba tu wprowadzić

różne polecenia w zależności od tego, czy używa się systemu

Windows, czy też jednego

z uniksowych systemów operacyjnych (a więc systemu

Linux, Unix lub Mac OS X).

Tworzenie pliku dystrybucji w systemie Windows

Jeśli korzystasz z systemu Windows, otwórz wiersz poleceń w folderze

zawierającym Twoje trzy pliki, a następnie wprowadź polecenie przedstawione poniżej.

c:\Users\lsuma\Desktop\Python\mymodules> py -3 setup.py sdist

Interpreter rusza do pracy natychmiast po tym, gdy zatwierdzisz to polecenie.

Na ekranie pojawi się spora liczba komunikatów, które zostały pokazane poniżej

w nieco skróconej formie.

running sdist

running egg_info

creating vsearch.egg-info

...

creating vsearch-1.0

creating vsearch-1.0\vsearch.egg-info

copying files to vsearch-1.0...

copying README.txt -> vsearch-1.0

...

creating dist

Creating tar archive

removing ‘vsearch-1.0’ (and everything under it)

Gdy ponownie pojawi się znak zachęty wiersza poleceń systemu Windows, Twoje

trzy pliki powinny już być połączone w jeden

plik dystrybucji

. Jest to plik, który

można zainstalować i który zawiera kod źródłowy Twojego modułu. W naszym

przypadku plik ten nosi nazwę

vsearch-1.0.tar.gz.

Nowo utworzone archiwum znajdziesz w folderze o nazwie

dist, który również

został utworzony przez narzędzie

setuptools

w folderze, z którego korzystasz

(w naszym przypadku jest nim folder

mymodules).

Uruchom interpreter

Pythona 3 w systemie

Windows.

Wykonaj kod

programu setup.py...

...i przekaż

sdist jako

argument.

Jeśli zobaczysz ten

komunikat, to znaczy,

że wszystko poszło

dobrze. Jeśli ujrzysz

jakieś komunikaty błędów,

sprawdź, czy korzystasz

z Pythona w wersji 3.4

lub nowszej, a także

upewnij się, że Twój plik

setup.py jest dokładnie

taki sam jak nasz.

Utwórz opis

dystrybucji.

Wygeneruj plik

dystrybucji.

Zainstaluj plik

dystrybucji.

jesteś tutaj�

181

Ponowne użycie kodu

Utwórz opis

dystrybucji.

Wygeneruj plik

dystrybucji.

Zainstaluj plik

dystrybucji.

Pliki dystrybucji w systemach uniksowych

Jeśli nie używasz systemu Windows, możesz utworzyć plik dystrybucji w sposób

bardzo podobny do tego, który został zaprezentowany na poprzedniej stronie.

Mając swoje trzy pliki (

vsearch.py, setup.py oraz README.txt) w folderze, wpisz

i zatwierdź przedstawione poniżej polecenie w systemowym wierszu poleceń.

mymodules$ python3 setup.py sdist

Uruchom interpreter Pythona 3.

Wykonaj kod

programu setup.py...

...i przekaż sdist

jako argument.

Podobnie jak w przypadku systemu Windows, spowoduje to wyświetlenie na ekranie

wielu komunikatów, z których wybrane pokazane zostały poniżej.

running sdist

running egg_info

creating vsearch.egg-info

...

running check

creating vsearch-1.0

creating vsearch-1.0/vsearch.egg-info

...

creating dist

Creating tar archive

removing ‘vsearch-1.0’ (and everything under it)

Gdy ponownie pojawi się znak zachęty systemowego wiersza poleceń, Twoje

trzy pliki powinny już być połączone w plik

źródła

dystrybucji

(ang. source

distribution

; stąd właśnie wziął się argument

sdist

). Jest to plik, który można

zainstalować i który zawiera kod źródłowy Twojego modułu. W naszym

przypadku plik ten nosi nazwę

vsearch-1.0.tar.gz.

Nowo utworzone archiwum znajdziesz w folderze o nazwie

dist, który również

został utworzony przez narzędzie

setuptools

w folderze, z którego korzystasz

(w naszym przypadku jest nim folder

mymodules).

Komunikaty mogą się tu

nieznacznie różnić od

tych, które można było

zobaczyć w systemie

Windows. Jeśli jednak

zobaczysz ten komunikat,

to znaczy, że wszystko

poszło dobrze. Jeśli nie,

sprawdź wszystko raz

jeszcze (podobnie jak

miało to miejsce

w przypadku Windowsa).

Skoro udało Ci się już utworzyć plik źródła dystrybucji

(w postaci skompresowanego archiwum tar), jesteś gotów

zainstalować swój moduł w pakietach.