我希望某个模块的接口(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)”符号。摆脱它们的最佳方法是什么?
我考虑的选项是
使用单个模块而不是包。界面看起来不错,但实现会比现在更不清晰。
添加行
del a, b, c, d
到
__init__.py
的结尾。工作正常,但看起来像 hack。 (例如,您不能再import __init__
,没有这一行也可以。)将
a
、b
、c
和d
重命名为_a
、_b
、_c
和_d
。现在它们作为“私有(private)”符号包含在mypackage
的命名空间中,我对此很满意,但感觉有点奇怪,所有 我的文件名都以下划线开头(实际上,子模块当然不止四个)。
有更好的建议吗?或关于更喜欢哪个选项的想法?
或者我只是为了肛交而不应该关心整个事情?
最佳答案
如果包中的某些文件确实是实现细节,请继续在它们前面加上下划线——这就是我们使用它们的目的。
例如,如果您查看 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
都成为该文件中的实现细节。
关于python - 如何将子模块名称保留在 Python 包的 namespace 之外?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/5265497/