8. Referencia de comandos
*************************

Nota:

  Este documento se conserva únicamente hasta que la documentación de
  "setuptools" en
  https://setuptools.readthedocs.io/en/latest/setuptools.html cubra de
  forma independiente toda la información relevante que se incluye
  actualmente aquí.


8.1. Instalando módulos: la familia de comandos **install**
===========================================================

Los comandos de instalación aseguran que los comandos de construcción
se han ejecutado y también se han ejecutado los subcomandos
**install_lib**, **install_data** y **install_scripts**.


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

Este comando instala todos los archivos de datos proporcionados con la
distribución.


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

Este comando instala todos los scripts (Python) en la distribución.


8.2. Creando una distribución de origen: el comando **sdist**
=============================================================

Los comandos de la plantilla manifest son:

+---------------------------------------------+-------------------------------------------------+
| Comando                                     | Descripción                                     |
|=============================================|=================================================|
| **include pat1 pat2 ...**                   | incluye todos los archivos que coincidan con    |
|                                             | cualquiera de los patrones enumerados           |
+---------------------------------------------+-------------------------------------------------+
| **exclude pat1 pat2 ...**                   | excluye todos los archivos que coincidan con    |
|                                             | cualquiera de los patrones enumerados           |
+---------------------------------------------+-------------------------------------------------+
| **recursive-include dir pat1 pat2 ...**     | incluye todos los archivos *dir* que coincidan  |
|                                             | con cualquiera de los patrones enumerados       |
+---------------------------------------------+-------------------------------------------------+
| **recursive-exclude dir pat1 pat2 ...**     | excluye todos los archivos *dir* que coincidan  |
|                                             | con cualquiera de los patrones enumerados       |
+---------------------------------------------+-------------------------------------------------+
| **global-include pat1 pat2 ...**            | incluye todos los archivos de cualquier lugar   |
|                                             | en el árbol fuente que coincidan --- y          |
|                                             | cualquiera de los patrones enumerados           |
+---------------------------------------------+-------------------------------------------------+
| **global-exclude pat1 pat2 ...**            | excluye todos los archivos de cualquier lugar   |
|                                             | en el árbol fuente que coincidan --- y          |
|                                             | cualquiera de los patrones enumerados           |
+---------------------------------------------+-------------------------------------------------+
| **prune dir**                               | excluye todos los archivos *dir*                |
+---------------------------------------------+-------------------------------------------------+
| **graft dir**                               | incluye todos los archivos *dir*                |
+---------------------------------------------+-------------------------------------------------+

Los patrones aquí son patrones "glob" de estilo Unix: "*" coincide con
cualquier secuencia de caracteres de nombre de archivo habitual, "?"
coincide con cualquier caracter de nombre de archivo habitual, y
"[range]" coincide con cualquiera de los caracteres en *range* (p.
ej., "a-z", "a-zA-Z", "a-f0-9_."). La definición de "caracter de
nombre de archivo habitual" es específica de la plataforma: en Unix es
cualquier cosa excepto barra; en Windows cualquier cosa excepto barra
invertida o dos puntos.
