首页 > 解决方案 > 对 __init__.py 的要求只是为了满足 pylint 和 mypy

问题描述

我有一个具有以下(部分)目录结构的项目

.
├── mypy.ini
├── src
│   ├── preppy
│   │   ├── cli.py
│   │   ├── __main__.py
│   │   ├── model.py
│   │   └── tools.py
├── pyproject.toml
└── tests

cli.py中,我有以下代码(文件中的第 13 和 14 行):

from .model import Problem
from .tools import get_abs_path, transcode

当工具在我的 IDE(代码 - OSS)中自动运行时,我也有类似样式的相对导入model.py和所有类似的导入都会在(2.5.3) 和(0.761)__main__.py 中引发错误,例如:pylintmypy

Attempted relative import beyond top-level package pylint(relative-beyond-top-level) [13,1]
Cannot find implementation or library stub for module named '.model' mypy(error) [13,1]
Attempted relative import beyond top-level package pylint(relative-beyond-top-level) [14,1]
Cannot find implementation or library stub for module named '.tools' mypy(error) [14,1]
See https://mypy.readthedocs.io/en/latest/running_mypy.html#missing-imports mypy(note) [13,1]

当我将空白__init__.py文件添加到文件夹时,错误消失了。

我不需要这个__init__.py文件来让包工作。

我认为在 PEP 420 之后,它不应该是必需的,特别是如果它只是为了满足 linter。

还有什么我做错了,还是我应该添加__init__.py并克服它:)?

配置pylintpyproject.toml

[tool.pylint.'MESSAGES CONTROL']
# Pylint and black disagree on hanging indentation.
disable = "C0330"

[tool.pylint.MISCELLANEOUS]
# Note: By default, "TODO" is flagged, this is disabled by omitting it
#       from the list below.
notes = "FIXME,XXX"

配置mypymypy.ini

[mypy]
disallow_untyped_calls = True
disallow_untyped_defs = True
disallow_incomplete_defs = True
disallow_untyped_decorators = True
mypy_path = src
namespace_packages = True

[mypy-openpyxl]
ignore_missing_imports = True

[mypy-pulp]
ignore_missing_imports = True

[mypy-pytest]
ignore_missing_imports = True

我正在运行 python 3.8.0。

标签: pythonpylintmypy

解决方案


PEP 420不允许“通过省略创建包__init__.py”,它强制“通过省略创建命名空间__init__.py”。这表示:

  • 如果你想要一个包,添加__init__.py.
  • 如果你想要一个命名空间包,请省略__init__.py.

虽然像常规包一样使用命名空间包通常可以工作,但当包名冲突时,它可能会意外失败。在大多数情况下,命名空间包是不可取的。


推荐阅读