python - setuptools.setup 对所有元数据关键字有何作用？

Question

我的项目已经到了我想要分发它的地步，所以我正在阅读 docs以便更好地熟悉所有信息。最终我发现自己在看distutils.core.setup以及与之相关的所有关键字，这让我想知道:

What are the keywords used for, where do they go and why do we need them?

在一些临时脚手架项目上运行sdist后，我注意到出现了PKG-INFO，其中包含一些元数据。但这是运行命令后我能找到它们的唯一地方。有 upload 命令(或者我可以使用 twine)将源代码分发到 PyPI 上，所以我想它可能是用于传递信息的约定，然后解析和加载到 PyPI 网页上进行分发？

Answer 1

so I suppose maybe its a convention used to pass information that is then parsed and loaded onto the PyPI web page for the distribution?

你说得完全正确。这些关键词大多代表各种core metadata定义所有 Python 包发行版的字段。

这些数据的路径大致是这样的:

• 您将关键字指定为 setup函数；
• 这是写给 PKG-INFO构建发行版时的文件；
• 上传时，twine读取自PKG-INFO确定有关您的发行版的所有元数据；
• twine将此元数据与您的 .zip 一起上传, .tar.gz或.whl文件
• PyPI 将此元数据存储在您项目的数据库中。