pythonsdist中应该包含哪些文件？

Question

我在问生成sdist的标准做法是什么。sdist是否应该有效地包含存储库中的大部分或全部文件？或者，sdist应该只包含生成存档所需的一组文件，例如whl或{}？在

这个问题出现在Trac project。让我举一些我正在考虑的文件的具体例子。我们应该包括吗？公司名称：

• RST格式的开发人员文档（这些文件不包括在我们分发的whl中）
• 存储库构件，如.gitignore
• contrib中不包含在egg或whl中但通常很有用的Python脚本
• 编译后的翻译目录（mo文件）是生成的工件，不存储在存储库中

Answer 1

源发行版用于安装包。pip下载sdist，解压并运行

python setup.py install

因此sdist必须包含构建和安装包所需的所有内容。其他的一切-由包装商决定。例如，sdist可以包含诸如docs之类的附加文件。在

Answer 2

源发行版（sdist）是一种用于从源文件安装库的分发格式。在

引用Python Packaging User Guide：

A distribution format (usually generated using python setup.py sdist) that provides metadata and the essential source files needed for installing by a tool like pip, or for generating a Built Distribution.

目前，我们使用Git、Subversion或Mercurial等版本控制系统来存储库的源代码。因此，sdist格式主要包含VCS所包含的内容。在

与Wheel格式相反，Wheel格式包含“运行”库/应用程序所需的所有内容。例如，Wheels不包含单元测试、文档等