5.2 Opciones relativas al manifiesto

El curso normal de operaciones de la orden sdist es la siguiente:

si no existe el fichero de manifiesto, MANIFEST, leer MANIFEST.in y crear MANIFEST
si no existe ni MANIFEST ni MANIFEST.in, crear un manifiesto con el conjunto predeterminado de ficheros³
si MANIFEST.in o el guion de configuración (setup.py) son más recientes que MANIFEST, recrear MANIFEST a partir de MANIFEST.in
usar la lista actual de ficheros de MANIFEST (recién generada o recuperada) para crear los archivos de distribución de fuentes

Hay un par de opciones que modifican este comportamiento. Se puede usar --no-defaults y --no-prune para desactivar los conjuntos estándar de inclusión y exclusión. Observa que si no hay plantilla de manifiesto ni manifiesto y se usa --no-defaults, se obtiene un manifiesto vacío. Otro error de Distutils 0.9.2 y anteriores causa una excepción fatal en tal caso. Evitarlo es fácil: no reproduzcas el caso descrito.

Además, es posible forzar la regeneración del manifiesto, por ejemplo, si se han añadido o eliminado ficheros o directorios que concuerdan con un patrón existente en el manifiesto, se debería regenerar el manifiesto:

python setup.py sdist --force-manifest

O puede que sólo se desee (re)generar el manifiesto, sin crear una distribución de fuentes:

python setup.py sdist --manifest-only

--manifest-only implica --force-manifest. -o es la abreviatura de --manifest-only y -f la de --force-manifest.

Notas al pie

... ficheros ³: En las versiones de las Distutils hasta la 0.9.2 inclusive (Python 2.0b1), esta característica no funcionaba; se debe usar la opción -f (--force-manifest) para superar el error.

Ver Sobre este documento... para obtener información sobre sugerencias.