El tutorial de empaquetado de Python recomienda que "se deben preferir los metadatos estáticos (setup.cfg). Los metadatos dinámicos (setup.py) deben usarse solo como vía de escape cuando sea absolutamente necesario. Setup.py solía ser necesario, pero se puede omitir con versiones más recientes de setuptools y pip".

La guía para empaquetar y distribuir proyectos explica que "setup.cfg es un archivo ini que contiene opciones predeterminadas para los comandos setup.py. Para ver un ejemplo, consulte setup.cfg en el proyecto de muestra de PyPA".

Ese ejemplo es completamente inútil, y no parece haber mucha otra información útil. Los ejemplos en el tutorial sugieren que algunos, o quizás todos, los argumentos válidos para setuptools.setup() se pueden enumerar en setup.cfg , pero no hay una explicación real para este efecto. En particular, no está claro cómo traducir un argumento de lista, como el del parámetro install_requires muy común e importante, en líneas en setup.cfg .

La forma correcta de hacer esto, como lo he determinado por deducción y experimentación, parece ser la siguiente:

 [options] install_requires = dependency_1 dependency_2

Obviamente, sería mejor que esto se documentara adecuadamente en algún lugar para que los nuevos creadores de paquetes no tengan que pasar por un proceso similar solo para especificar las dependencias de sus proyectos.

¿Existe tal documentación?