正确构建 Python 包？

Question

我有一个类似这样结构的 Python3.7 包。

project             # Repository
--\README
--\LICENSE
--\setup.py
--\project          # Source
----\project.py
----\__init__.py    # Init1
----\functions
-------\__init__.py # Init2
-------\moduleA.py
-------\ ...
-------\moduleZ.py

在project.py里面我有以下内容。

from functions.moduleA import functionA
from functions.moduleB import functionB
...
functionA = functionA
functionB = functionB

Init2 完全空白。但 Init1 有以下内容。

from .project import functionA
from .project import functionB

但是当我在 Repository 目录中执行$ python -c 'import project' 时，我得到一个ModuleNotFoundError: No module named 'functions'。这里可能有一些非常简单的问题。不过，导入在 Source 目录中可以正常工作。最终，我对用户通过setup.py 安装所有东西并像这样使用我的项目感兴趣。

import project

project.functionA(...)
...
project.functionB(...)

Answer 1

您的project.py 文件无法按您的预期工作。这些行导致错误：

from functions.moduleA import functionA
from functions.moduleB import functionB

这些导入不起作用，因为functions 不是顶级模块，而是属于project 包的子包。您可以通过在每个模块名称（.functions.moduleA 等）的开头添加 . 来修复它们。我想你也可以命名绝对模块名称，如果你出于某种原因喜欢它（例如project.functions.moduleA）。

赋值语句也不做任何事情。 functionA = functionA 可以删除，完全没有区别。

我不太清楚project.py 文件的用途是什么。 project/__init__.py 文件旁边似乎完全多余，似乎它应该包含完全相同的值。可能您应该将它们合并到一个文件中（可能是__init__.py 文件）。

我还会仔细考虑您是否真的需要这么多子包和模块。虽然有时只是风格问题，但将密切相关的东西放在同一个模块中会非常方便。您当然不需要为您编写的每个函数都使用单独的模块！