5

我想创建一个包作为扩展安装到另一个 python 包的子模块中。

基本上原始模块的设置如下:

origmodule/
    __init__.py
    stuff.py
    ext/
        __init__.py
        # This module is empty

然后将我的扩展模块安装到空的 origmodule.ext 模块中。阅读说明distutils尚不清楚这是否可行或受支持。最终目标是让我的扩展模块一旦安装就可以像这样导入:

import origmodule.ext.my_extension

4

1 回答 1

5

您无法使用 setuptools 执行此操作,支持在另一个包中安装。

相反,您想使用入口点。您origmodule应该寻找任何注册为特定键的入口点的东西,并且您的extension模块应该为该键注册自己。

您的扩展注册了一个扩展点:

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 项目为例。Babel 可以从文件中提取可翻译的文本;它知道如何对 Python 源代码执行此操作,但它还支持可以从其他格式中提取此类文本的扩展。

这种提取方法可以注册为扩展点。Babel 在写作提取方法部分记录了这一点。然后,消息提取代码在提取文本时加载这些入口点:

GROUP_NAME = 'babel.extractors'

# ...

for entry_point in working_set.iter_entry_points(GROUP_NAME,
                                                 method):
    func = entry_point.load(require=True)
    break

Mako 模板语言提供了这样一个插件;它注册了指向实际实现的入口点

[babel.extractors]
mako = mako.ext.babelplugin:extract
def extract(fileobj, keywords, comment_tags, options):
    # ...
于 2013-04-15T17:01:01.283 回答