如何在同一 python package 中的模块之间设置导入和依赖关系

Question

我正在 python 中编写一个库。 它有一个 package 和 3 个模块，如

mypackage
    __init__.py
    utils.py
    fileio.py
    math.py

如果我只是将__init__.py留空，我的用户必须弄清楚哪些函数在哪些模块中，这很烦人。 我拥有三个模块这一事实是一个不重要的实现细节。

也许我应该将主要功能导入__init__.py ，就像这样

from .utils import create_table
from .fileio import save_rows, load_rows
from .math import matrix_inverse

这样我的用户就可以做到

import mypackage as myp

rows = myp.load_rows()

这是最佳做法吗？

将所有符号放入__init__.py的替代方案怎么样，例如

from .utils import *
from .fileio import *
from .math import *

如果有任何我不想公开的功能，我会在它们前面加上下划线。 那个更好吗？ 这对我来说当然更容易。

如果fileio.py需要调用utils.py中的一些函数怎么办？ 我可以把

from .utils import *

进入fileio.py ，但这不会创建循环或冗余引用吗？ 处理这个问题的最佳方法是什么？

Answer 1

也许我应该将主要功能导入init .py，像这样 [...] 这是最佳实践吗？

我不会说有“最佳实践”，它取决于具体情况，但这肯定很常见：您在每个模块中定义一堆东西，并在__init__中导入相关的东西。 这是一种不用担心用户记住哪个子模块具有所需的 function 的简单方法，但是如果您要从每个模块导入很多函数，它会变得非常烦人。

将所有符号放入init .py 的替代方案怎么样，例如

from.utils import * from.fileio import * from.math import *

你很可能不想这样做。 这会导入用户模块中的所有内容，包括其他导入的模块和内部函数。 你应该避免它。

如果fileio.py需要调用utils.py中的一些函数怎么办？ [...] 这不会创建循环或冗余引用吗？

是的，这是可能发生的事情，你通常想不惜一切代价避免它。 如果您需要utils.py中的fileio.py中的某些功能，则应将它们显式导入为from.utils import x, y, z 。 请记住，在相同 package 的模块之间导入内容时也始终使用相对导入（即使用from.utils import x ，而不是from package.utils import x ）。

---

您提到的这两个选项之间的一个很好的折衷方案可以解决上述大多数问题（尽管不是循环导入，但您必须自己避免这些问题）是在每个模块中定义一个__all__列表以指定应该导出哪些函数使用from x import *时，如下所示：

# utils.py

import sys

__all__ = ['user_api_one', 'user_api_two']

def user_api_one():
    ...

def user_api_two():
    ...

def internal_function():
    ...

如果您在所有模块中正确定义了一个__all__列表，那么在您的__init__.py中，您将能够安全地执行以下操作：

from .utils import *
from .fileio import *
from .math import *

这只会导入相关函数（例如user_api_one和user_api_two用于utils ，而不是internal_function或sys ）。