如何用Python Setuptools打包多个单个模块作为子包装

Question

我的目录结构看起来像是以下。

pkg-folder
├── LICENSE
├── pkg-name
│   ├── __init__.py
│   ├── module1
│   │   ├── module1.py
│   │   ├── __init__.py
│   │   └── resourceFile.json
│   └── module2
│       ├── __init__.py
│       └── module2.py
├── README.md
├── setup.py
├── MANIFEST.ini
└── setup.cfg

构建和安装软件包后，我必须如下导入。

from pkg-name.module1.module1 import func1

当我知道Module1.py是子包中的一个文件时，我该如何直接导入如下所示？

from pkg-name.module1 import func1

我的__ INIT __。py's是空白的。

Answer 1

您已经部分回答了自己的问题：

我的__ INIT __。py是空白的。

导入软件包时，解释器会在软件包的__ Init __. Py文件中检查名称绑定。 empty __ init __。py文件仅提供同一目录中的子模块的名称绑定。例如，如果您的软件包结构

pkg_folder
└── pkg_name
    └── __init__.py

和__ INT __。py包含一些定义，例如x = 2，则使用pkg_folder作为当前工作目录或安装到python环境的软件包，您可以导入x使用，

from pkg_name import x

但是，如果x在a subsodule ，情况有些不同。考虑以下软件包结构：

pkg_folder
└── pkg_name
    ├── __init__.py
    └── module1.py

导入pkg_name再次告诉解释器以检查pkg_name/__ Init __. py for name bindings。如果定义x = 2在module1.py而不是__ init __. py中，那么它不是pkg_name 的范围；取而代之的是，它属于pkg_name.module1，因此以下功能：

from pkg_name.module1 import x

但是，您可以通过在__ Init __ Init中定义一个名称来明确地将其添加到pkg_name 。 >。在这种情况下，__ init __. py可能会读：

from .module1 import x

因为x现在在__ init __ init __. py中定义，允许我们在<<中定义。代码> pkg_name ：同样的

from pkg_name import x

逻辑适用于子包装中的模块。因此，对于您要寻找的行为，您需要填充子包的__ init __. py文件，其中包含来自子包装中其他模块的软件包相对导入的文件。

从

from pkg_name.module1.module1 import func1

您的pkg_name/module1/__ init __。py文件

from pkg_name.module1 import func1

可能类似于以下内容：

from .module1 import func1

如果您有理由，您甚至可以将其扩展到传播func1 func1 父包。