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.