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.
