有“setup.cfg”的完整文档吗?

int*_*ted 31 python packaging setuptools setup.py

Python打包教程建议“应首选静态元数据 (setup.cfg)。动态元数据 (setup.py) 仅应在绝对必要时用作逃生舱口。setup.py 曾经是必需的,但可以通过省略新版本的 setuptools 和 pip。”

打包和分发项目指南解释说“setup.cfg 是一个 ini 文件,其中包含 setup.py 命令的默认选项。有关示例,请参阅 PyPA 示例项目中的 setup.cfg。”

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

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

[options]
install_requires =
    dependency_1
    dependency_2
Run Code Online (Sandbox Code Playgroud)

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

存在这样的文档吗?

hon*_*ger 18

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

  • 唯一的缺点是它实际上并不是非常完整的文档。有很多地方都说你可以放置东西,但没有说这些东西应该使用什么词汇。 (3认同)