如何在（子）模块中使用__init__.py定义名称空间？

Question

我的问题是关于编写Python（3.x）软件包和（子）模块以及__init__.py文件的正确用法以声明名称空间。
我曾经用C ++编写代码，所以我喜欢使用很多单独的文件来组织项目。例如，（imo）如果一个模块包含多个类，则每个类应位于单独的文件中。

由于我没有使用Python进行开发的经验，因此很难用一个简单的问题来表达我的想法。因此，让我们以下面的小python包为例。

dir
 |
 +-- example
 |    |
 |    +-- script.py
 |
 +-- package
      |
      +-- __init__.py
      |
      +-- foo.py
      |
      +-- subpackage
           |
           +-- __init__.py
           |
           +-- bar.py

让我们看一下文件。

文件内容

package/foo.py：

def foo:
    print('foo')

package/subpackage/bar.py：

def bar:
    print('bar')

以下example/script.py工作正常。

import sys
sys.path.insert(0, '..')

import package
import package.subpackage


package.foo.foo()
package.subpackage.bar.bar()

我不喜欢使用package.foo.foo()/
package.subpackage.bar.bar()，而是想使用package.foo()/
package.subpackage.bar()。

而且我不想使用from package.subpackage.bar import bar，因为我不想将子包的名称空间混入脚本中。

解

我使用__init__.py文件来实现这一目标。

package/__init__.py：

from package.foo import foo

package/subpackage/__init__.py：

from package.subpackage.bar import bar

问题

• 这是一种类似python的好方法来定义名称空间吗？还是有一种更好/常见的方式来组织python文件包的文件系统。（我没有为此找到合适的教程/示例。）

• 在file中package/subpackage/__init__.py，为什么必须是：

from package.subpackage.bar import bar

并不是：

from subpackage.bar import bar？

这将导致错误：

Traceback (most recent call last):
File "script.py", line x, in <module>
import package.subpackage
File "..\package\subpackage\__init__.py", line x, in <module>
from subpackage.bar import bar
ImportError: No module named 'subpackage'

Answer 1

这是一种类似python的好方法来定义名称空间吗？还是有一种更好/常见的方式来组织python文件包的文件系统。（我没有为此找到合适的教程/示例。）

这是设置Python包的 不错 方法。只有 还好 并没有因为内容“好”foo.py和bar.py。

我不喜欢使用package.foo.foo()/
package.subpackage.bar.bar()，而是想使用package.foo()/
package.subpackage.bar()。

在这种情况下，您不能这样做。不混合名称空间是不这样做的充分理由from package.subpackage.bar import bar。

这本来是更好，如果def foo(): ...和def bar(): ...是直接__init__.py。这样，您可以完成package.foo()和package.subpackage.bar()。也可以通过使用__all__init来完成，但import *也不被认为是好的。

或者，foo和bar包应该有更多在它喜欢foo.function1，foo.other_func，bar.drink等这使得它更加人性化理解的组织。

示例和参考文献不在适用于StackOverflow良好问题的范围内，但以下是一些经过深思熟虑的问题：

• 结构化项目—《 Python旅行者指南》
• 组织模块和包的Python方式
• 如何组织一个Python项目？