# 8. Podręcznik poleceń

Informacja

Ten dokument jest przechowywany wyłącznie do czasu, gdy dokumentacja `setuptools` pod adresem https://setuptools.readthedocs.io/en/latest/setuptools.html niezależnie obejmie wszystkie istotne informacje, które są tutaj zawarte.

## 8.1. Instalowanie modułów: rodzina poleceń install

Polecenie install zapewnia, że polecenia budowy zostały uruchomione a potem uruchamia podrzędne polecenia install_lib, install_data i install_scripts.

### 8.1.1. install_data

To polecenie instaluje wszystkie pliki danych dostarczone do dystrybucji.

### 8.1.2. install_scripts

To polecenie instaluje wszystkie skrypty języka pytonowskiego w dystrybucji.

## 8.2. Creating a source distribution: the sdist command

Polecenia wzorca manifestu to:

Polecenie | Opis
--- | ---
include pat1 pat2 ... | załącz wszystkie pliki pasujące do któregokolwiek wzorca
exclude pat1 pat2 ... | wyłącz wszystkie pliki pasujące nazwą do któregokolwiek z wzorców
recursive-include kat pat1 pat2 ... | załącz wszystkie pliki pod kat pasujące do któregokolwiek z wzorców
recursive-exclude kat pat1 pat2 ... | wyłącz wszystkie pliki pod kat pasujące do któregokolwiek z wzorców na liście
global-include pat1 pat2 ... | załącz wszystkie pliki gdziekolwiek w drzewie źródłowym pasujące — do któregokolwiek z wymienionych wzorców
global-exclude pat1 pat2 ... | wyłącz wszystkie pliki gdziekolwiek w źródłowym drzewie pasujące nazwą — do któregokolwiek z wymienionych wzorców
prune dir | wyłącz wszsytkie pliki w katalogu dir
graft dir | załącz wszystkie pliki w katalogu dir

Wzorce tutaj są w stylu Unix-owym „glob”-wzorcami: `*` dopasowuje do dowolnego ciągu zwykłych znaków nazwy pliku, `?` dopasowuje jeden zwykły znak nazwy pliku, a `[zakres]` dopasowuje którekolwiek znaki z zakresu (np. `a-z`, `a-zA-Z`, `a-f0-9_.`). Definicja „zwykłego znaku nazwy pliku” jest zależna od maszyny/środowiska: na Unix-ie to wszystko oprócz ukośnika; w Windows wszystko oprócz skośnika lub dwukropka.