Python：在当前模块中导入和更改规范名称

Question

在我自己创建的 Python 包目录中，我有一个 __init__.py 文件，上面写着：

from _foo import *

在同一个目录下有一个_foomodule.so，它是由上面加载的。共享库是用 C++ 实现的（使用 Boost Python）。这让我说：

import foo
print foo.MyCppClass

这可行，但有一个怪癖：Python 通过完整的包路径知道该类，这使得它可以打印：

foo._foo.MyCppClass

因此，虽然 MyCppClass 在 foo 中作为别名存在，但 foo.MyCppClass 并不是它的规范名称。除了有点丑之外，这也让help() 有点蹩脚：help(foo) 会说 foo 包含一个模块 _foo，只有当你说 help(foo._foo) 时，你才会得到 MyCppClass 的文档。

我是否可以在 __init__.py 中做一些不同的事情或以其他方式使 Python 将 foo.MyCppClass 视为规范名称？

我使用的是 Python 2.7；如果该解决方案也适用于 2.6，那就太好了。

Answer 1

你可以通过添加这行来解决help()的问题

__all__ = ['MyCppClass']

到您的__init__.py 文件。

Answer 2

我遇到了同样的问题。您可以在 Boost.Python 定义中更改模块名称：

BOOST_PYTHON_MODULE(_foo)
{
  scope().attr("__name__") = "foo";
  ...
}

帮助问题是一个单独的问题。我认为您需要将每个项目添加到 __all__ 以将其导出以提供帮助。

当我同时执行这两项操作时，foo.MyCppClass 的名称就是 -- foo.MyCppClass -- 并且 help(foo) 提供了 MyCppClass 的文档。