如何在没有 MANIFEST.in 文件的情况下包含 package_data?
How can I include package_data without a MANIFEST.in file?
如何在没有 MANIFEST.in 文件的情况下为 sdist
添加 package_data
?
我的 setup.py 看起来像这样:
import setuptools
setuptools.setup(
name='foo',
version='2015.3',
license='commercial',
packages=setuptools.find_packages(),
package_data={'': ['foo/bar.txt']},
)
版本:
user@host> python
Python 2.7.6 (default, Mar 22 2014, 22:59:56)
>>> import setuptools
>>> setuptools.version.__version__
'3.6'
我只是无法 foo/bar.txt
包括在内。
或者是this blog post still true? http://blog.codekills.net/2011/07/15/lies,-more-lies-and-python-packaging-documentation-on--package_data-/
不过,在过去的一个小时里,我了解到这些陈述介于“危险的误导”和“该死的谎言”之间。
这是因为 Python 包的主要类型是源包,而创建源包的规范方法是使用 setup.py sdist
。但是,package_data 中指定的数据未包含在源代码分发中 — 它们仅包含在二进制 (setup.py bdist
) 分发和安装 (setup.py install
) 中。
如何在没有 MANIFEST.in 文件的情况下为 sdist
添加 package_data
?
TL;DR: package_data
字典中的关键字是 packages;这些值是 glob 的列表。 ''
不是任何 Python 包的有效名称。
如果要将 bar.txt
安装在软件包 foo
的 __init__.py
旁边,请使用
package_data={'foo': ['bar.txt']}
我有布局:
foo/
__init__.py
bar.txt
setup.py
现在,如果 foo
是一个像上面那样的包,那么:
import setuptools
setuptools.setup(
name='foo',
version='2015.3',
license='commercial',
packages=setuptools.find_packages(),
package_data={'foo': ['bar.txt']},
)
在python setup.py sdist
之后,我检查了dist/foo-2015.3.tar.gz
的内容
% tar tfz dist/foo-2015.3.tar.gz
...
foo-2015.3/foo/bar.txt
...
但是,如果我 运行 你的 setup.py
和 package_data={'': ['foo/bar.txt']}
,我可以同意 foo/bar.txt
将 而不是 添加到源代码分发中,除非 foo-2015.3.egg-info/SOURCES.txt
已经有 foo/bar.txt
的行 - 在这种情况下,文件也会在源代码分发中弹出
没有使用清单; setuptools 版本是 3.6
(我故意安装了与您使用的相同的旧版本):
>>> import setuptools
>>> setuptools.__version__
'3.6'
上述行为也适用于标准 distutils
: "legacy" distutils 文档的 2.6 Installing package data;对 2.7、3.1 的评论:
Changed in version [2.7, 3.1]: All the files that match package_data
will be added to the MANIFEST
file if no template is provided.
我遇到了同样的问题并修复了它:
include_package_data=True
如何在没有 MANIFEST.in 文件的情况下为 sdist
添加 package_data
?
我的 setup.py 看起来像这样:
import setuptools
setuptools.setup(
name='foo',
version='2015.3',
license='commercial',
packages=setuptools.find_packages(),
package_data={'': ['foo/bar.txt']},
)
版本:
user@host> python
Python 2.7.6 (default, Mar 22 2014, 22:59:56)
>>> import setuptools
>>> setuptools.version.__version__
'3.6'
我只是无法 foo/bar.txt
包括在内。
或者是this blog post still true? http://blog.codekills.net/2011/07/15/lies,-more-lies-and-python-packaging-documentation-on--package_data-/
不过,在过去的一个小时里,我了解到这些陈述介于“危险的误导”和“该死的谎言”之间。
这是因为 Python 包的主要类型是源包,而创建源包的规范方法是使用 setup.py sdist
。但是,package_data 中指定的数据未包含在源代码分发中 — 它们仅包含在二进制 (setup.py bdist
) 分发和安装 (setup.py install
) 中。
如何在没有 MANIFEST.in 文件的情况下为 sdist
添加 package_data
?
TL;DR: package_data
字典中的关键字是 packages;这些值是 glob 的列表。 ''
不是任何 Python 包的有效名称。
如果要将 bar.txt
安装在软件包 foo
的 __init__.py
旁边,请使用
package_data={'foo': ['bar.txt']}
我有布局:
foo/
__init__.py
bar.txt
setup.py
现在,如果 foo
是一个像上面那样的包,那么:
import setuptools
setuptools.setup(
name='foo',
version='2015.3',
license='commercial',
packages=setuptools.find_packages(),
package_data={'foo': ['bar.txt']},
)
在python setup.py sdist
之后,我检查了dist/foo-2015.3.tar.gz
% tar tfz dist/foo-2015.3.tar.gz
...
foo-2015.3/foo/bar.txt
...
但是,如果我 运行 你的 setup.py
和 package_data={'': ['foo/bar.txt']}
,我可以同意 foo/bar.txt
将 而不是 添加到源代码分发中,除非 foo-2015.3.egg-info/SOURCES.txt
已经有 foo/bar.txt
的行 - 在这种情况下,文件也会在源代码分发中弹出
没有使用清单; setuptools 版本是 3.6
(我故意安装了与您使用的相同的旧版本):
>>> import setuptools
>>> setuptools.__version__
'3.6'
上述行为也适用于标准 distutils
: "legacy" distutils 文档的 2.6 Installing package data;对 2.7、3.1 的评论:
Changed in version [2.7, 3.1]: All the files that match
package_data
will be added to theMANIFEST
file if no template is provided.
我遇到了同样的问题并修复了它:
include_package_data=True