Python __init__.py，较少污染的命名空间

Question

我有一个目录结构

foobar/
    __init__.py
    baz.py

其中 __init__.py 只是

from .baz import do_something

和baz.py

def do_something():
    return

现在，当我导入 foobar 时，我可以访问

foobar
foobar.do_something()

不错!不过，也有

foobar.baz

尽管它从未明确导入。我想它已经与 do_something 一起导入了。

有没有一种方法可以使 do_something 用作 foobar.do_something 而不将 foobar.baz 添加到命名空间？ (并且无需将所有内容放入 __init__.py 中。)

Answer 1

此行为记录在 chapter 5 of the Python Language Reference 中。如果您确实想要禁用它，可以在__init__.py中执行此操作:

from .baz import do_something
del baz

导入时会从 foobar 的命名空间中删除 baz。

但是，据我所知，这并不常见。您想要这样做有什么特殊原因吗？