是否有 `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
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