我想创建一个安装到另一个python包的子模块作为扩展的包.
基本上原始模块设置如下:
origmodule/
__init__.py
stuff.py
ext/
__init__.py
# This module is empty
然后将我的扩展模块安装到空的origmodule.ext模块中.阅读distutils的说明,目前尚不清楚这是否可行或支持.最终目标是安装后我的扩展模块将像这样导入:
import origmodule.ext.my_extension
解决方法:
你不能用setuptools做到这一点,不支持在另一个包内安装.
相反,您想要使用entry points.您的origmodule应该查找注册为特定键的入口点的任何内容,并且您的扩展模块应该为该键注册自己.
您的扩展程序注册了扩展点:
entry_points={
'some.opaque.string.unique.to.origmodule':
['my_extension = my.extension.package:some.entry.point', ]
}
然后你的origmodule可以通过询问pkg_resources来发现:
import pkg_resources
for entrypoint in pkg_resources.iter_entry_points(group='some.opaque.string.unique.to.origmodule'):
extension = entrypoint.load()
以Babel project为例. Babel可以从文件中提取可翻译的文本;它知道如何为Python源代码执行此操作,但它也支持可以从其他格式提取此类文本的扩展.
这种提取方法可以注册为扩展点. Babel在 Writing Extraction Methods部分对此进行了记录.提取文本时的消息提取代码然后loads those entry points:
GROUP_NAME = 'babel.extractors'
# ...
for entry_point in working_set.iter_entry_points(GROUP_NAME,
method):
func = entry_point.load(require=True)
break
Mako templating language提供这样的插件;它registers the entry point,指向actual implementation:
[babel.extractors]
mako = mako.ext.babelplugin:extract
def extract(fileobj, keywords, comment_tags, options):
# ...