是否有 `setup.cfg` 的完整文档?

Is there complete documentation for `setup.cfg`?

Python Packaging Tutorial 建议“首选静态元数据 (setup.cfg)。动态元数据 (setup.py) 应仅在绝对必要时用作逃生舱口。setup.py 过去是必需的,但可以在较新版本的 setuptools 和 pip 中省略。"

guide to packaging and distributing projects 解释说“setup.cfg 是一个 ini 文件,其中包含 setup.py 命令的选项默认值。有关示例,请参阅 PyPA 示例中的 setup.cfg项目。

该示例完全没有用,而且似乎没有很多其他有用的信息。教程中的示例表明 setuptools.setup() 的一些或可能全部有效参数可以列在 setup.cfg 中,但没有对此效果的真正解释。特别是,不清楚如何将列表参数(例如非常常见且重要的 install_requires 参数)转换为 setup.cfg.

中的行

我通过推导和实验确定的正确方法如下:

[options]
install_requires =
    dependency_1
    dependency_2

显然,最好将其正确记录在某处,这样新的包创建者就不必为了指定项目的依赖项而经历类似的过程。

是否存在此类文档?

是的,在setuptools的文档中。这是:https://setuptools.readthedocs.io/en/latest/userguide/declarative_config.html