定义跨项目模块共享的命名空间包

在Python中，命名空间包提供了一种跨多个项目构建相关代码的方法。要定义命名空间包，必须避免将 __init__.py 文件放置在命名空间包目录中。

命名空间包的演变

在 Python 3.3 之前，需要命名空间包使用 pkgutil.extend_path() 或 pkg_resources.declare_namespace() 显式声明。然而，从Python 3.3开始，引入了隐式命名空间包，无需任何声明即可无缝创建它们。

与常规包交互

命名空间包可以与常规包共存，允许分层结构。当在命名空间包中导入模块时，Python 在父包的 path 中搜索，将搜索扩展到标准 sys.path 之外。

pkgutil.extend_path() 与pkg_resources.declare_namespace()

同时 pkgutil.extend_path() 和 . pkg_resources.declare_namespace() 以前用于定义命名空间包，建议使用前者，因为它与隐式命名空间包具有面向未来的兼容性。

示例结构

考虑以下目录结构：

Package-1/namespace/
Package-2/namespace/
├── path1
│  └── package
│     ├── __init__.py
│     └── foo.py
├── path2
│  └── package
│     └── bar.py
└── path3
    └── package
        ├── __init__.py
        └── baz.py

在 __init__.py 文件中添加必要的extend_path 声明，诸如namespace.foo、namespace.bar 和namespace.baz 之类的导入都会成功。