python - 如何将子模块名称保留在 Python 包的 namespace 之外？

Question

我希望某个模块的接口(interface)包含一定数量的函数和类(仅此而已)。我可以在一个文件中实现所有这些，并且很容易获得我想要的界面。但是因为有很多代码，我宁愿把整个东西分成几个文件，比如说

mypackage/
    __init__.py
    a.py
    b.py
    c.py
    d.py

无论如何，为了获得所需的接口(interface)，我为从 a、b 导入所有公共(public)符号的包定义了一个 __init__.py 文件, c 和 d:

from a import func_a1, func_a2, ClassA1, ClassA2
from b import func_b1, func_b2, ClassB1, ClassB2
from c import func_c1, func_c2, ClassC1, ClassC2
from d import func_d1, func_d2, ClassD1, ClassD2

如果我使用导入包

import mypackage

包命名空间还包含符号a、b、c 和d。这些名称是实现细节，而不是我的界面的一部分。我不希望它们显示为“公共(public)”符号。摆脱它们的最佳方法是什么？

我考虑的选项是

1. 使用单个模块而不是包。界面看起来不错，但实现会比现在更不清晰。

2. 添加行

   del a, b, c, d
   

   到 __init__.py 的结尾。工作正常，但看起来像 hack。 (例如，您不能再import __init__，没有这一行也可以。)

3. 将a、b、c和d重命名为_a、_b、_c 和 _d。现在它们作为“私有(private)”符号包含在 mypackage 的命名空间中，我对此很满意，但感觉有点奇怪，所有 我的文件名都以下划线开头(实际上，子模块当然不止四个)。

有更好的建议吗？或关于更喜欢哪个选项的想法？

或者我只是为了肛交而不应该关心整个事情？

Answer 1

如果包中的某些文件确实是实现细节，请继续在它们前面加上下划线——这就是我们使用它们的目的。

例如，如果您查看 ctypes，您会看到

__init__.py
==================================================
"""create and manipulate C data types in Python"""

import os as _os, sys as _sys

__version__ = "1.1.0"

from _ctypes import Union, Structure, Array
from _ctypes import _Pointer
from _ctypes import CFuncPtr as _CFuncPtr
...

如您所见，甚至 os 和 sys 都成为该文件中的实现细节。