8. Referência de comando
************************

Nota:

  Este documento está sendo mantido apenas até que a documentação do
  "setuptools" em
  https://setuptools.readthedocs.io/en/latest/setuptools.html cubra
  independentemente todas as informações relevantes atualmente
  incluídas aqui.


8.1. Instalando módulos modules: a família de comandos **install**
==================================================================

O comando de instalação garante que os comandos de compilação tenha
sido executado e, então, executa os subcomandos **install_lib**,
**install_data** e **install_scripts**.


8.1.1. **install_data**
-----------------------

Este comando instala todos os arquivos de dados fornecidos com a
distribuição.


8.1.2. **install_scripts**
--------------------------

Este comando instala todos os scripts (Python) na distribuição.


8.2. Criando uma distribuição de fontes: o comando **sdist**
============================================================

Os comandos do modelo de manifesto são:

+---------------------------------------------+-------------------------------------------------+
| Comando                                     | Descrição                                       |
|=============================================|=================================================|
| **include pad1 pad2 ...**                   | inclui todos os arquivos que correspondem a     |
|                                             | qualquer um dos padrões listados                |
+---------------------------------------------+-------------------------------------------------+
| **exclude pad1 pad2 ...**                   | exclui todos os arquivos que correspondem a     |
|                                             | qualquer um dos padrões listados                |
+---------------------------------------------+-------------------------------------------------+
| **recursive-include dir pad1 pad2 ...**     | inclui todos os arquivos em *dir* que           |
|                                             | correspondam a qualquer um dos padrões listados |
+---------------------------------------------+-------------------------------------------------+
| **recursive-exclude dir pad1 pad2 ...**     | exclui todos os arquivos em *dir* que           |
|                                             | correspondam a qualquer um dos padrões listados |
+---------------------------------------------+-------------------------------------------------+
| **global-include pad1 pad2 ...**            | inclui todos os arquivos em qualquer lugar na   |
|                                             | árvore de fontes correspondente --- e qualquer  |
|                                             | um dos padrões listados                         |
+---------------------------------------------+-------------------------------------------------+
| **global-exclude pad1 pad2 ...**            | exclui todos os arquivos em qualquer lugar na   |
|                                             | árvore de fontes correspondente --- e qualquer  |
|                                             | um dos padrões listados                         |
+---------------------------------------------+-------------------------------------------------+
| **prune dir**                               | exclui todos os arquivos em *dir*               |
+---------------------------------------------+-------------------------------------------------+
| **graft dir**                               | inclui todos os arquivos em *dir*               |
+---------------------------------------------+-------------------------------------------------+

Os padrões aqui são padrões "glob" no estilo Unix: "*" corresponde a
qualquer sequência de caracteres regulares de nome de arquivo, "?"
corresponde a qualquer caractere comum de nome de arquivo regular e
"[intervalo]" corresponde a qualquer um dos caracteres em *intervalo*
(por exemplo, "az", "a-zA-Z", "a-f0-9_."). A definição de "caractere
de nome de arquivo comum" é específica da plataforma: no Unix, é
qualquer coisa, exceto barra; no Windows qualquer coisa, exceto
contrabarra ou dois pontos.
