python项目需要MANIFEST.in吗？它应该包含什么？

Question

“Python Distribute”指南（位于Python-Distribute.org，但注册已经失效）告诉我要包含doc/txt文件，并且.py文件被排除在MANIFEST.in文件中

sourcedist documentation告诉我只有sdist使用MANIFEST.in，并且只包含您指定的文件和要包含的.py文件。它还告诉我使用python setup.py sdist --manifest-only来生成MANIFEST，但是python告诉我这不存在

我很欣赏这些来自不同版本的python，并且发行系统在 完全混乱，但假设我使用的是python 3和setuptools（新的包括distribute但现在称为setuptools的新工具，而不是旧的setuptools，旧的setuptools已经被弃用，因为distribute工具只会被带回到distribute并被重命名为setuptools…..）

我遵循“标准”文件夹结构和setup.py文件

1. 我需要一个MANIFEST.in吗？
2. 里面应该有什么？
3. 什么时候所有这些不同的包装系统和方法将被制成一个单一的简单过程？

Answer 1

旧问题，新答案：

不，你不需要MANIFEST.in。然而，要想让setuptools达到您（通常）的意思，您确实需要使用setuptools_scm，它在两个关键位置扮演MANIFEST.in的角色：

• 它确保在运行sdist命令时打包所有相关文件（其中所有相关文件都定义为“受源代码管理的所有文件”）
• 当使用include_package_data将包数据包含在build或bdist_wheel中时。（同样：受源代码管理的文件）

对MANIFEST.in的历史理解是：当您没有源代码管理系统时，您需要一些其他机制来区分“源文件”和“恰好位于工作目录中的文件”。但是，您的项目受源代码管理（对吗？）所以不需要MANIFEST.in。More info in this article。