pycodestyle（例如 pep8）与 pylint 严格性

Question

我有一个

python

项目，我想检查它是否符合 PEP 8。

我的

setyp.cfg

如下：

[pycodestyle]
count = True
ignore = E266, W504
max-line-length = 80
statistics = True
exclude = .venv,./build%

经过一番清理后，我的

pycodestyle

检查现在没有产生任何错误或警告（当然忽略了那些）

~/Workspace/my-app  master ✔                                                                                                                        2h36m
➢  pycodestyle .
(.venv)
~/Workspace/my-app  master ✔

但是，针对我的项目运行

pylint

会产生大量错误：

（其中一些仅用于演示目的）

************* Module somemodule.commands
src/somemodule/commands.py:98:0: C0330: Wrong continued indentation (add 16 spaces).
                            format(gcp_project)))
                            ^               | (bad-continuation)
src/somemodule/commands.py:1:0: C0111: Missing module docstring (missing-docstring)
src/somemodule/commands.py:21:-1: W0105: String statement has no effect (pointless-string-statement)
src/somemodule/commands.py:29:4: C0103: Variable name "p" doesn't conform to snake_case naming style (invalid-name)
src/somemodule/commands.py:45:4: C0103: Variable name "p" doesn't conform to snake_case naming style (invalid-name)
src/somemodule/commands.py:41:16: W0613: Unused argument 'g_project' (unused-argument)
src/somemodule/commands.py:58:0: C0111: Missing function docstring (missing-docstring)
src/somemodule/commands.py:59:4: C0103: Variable name "p" doesn't conform to snake_case naming style (invalid-name)
src/somemodule/commands.py:100:4: R1705: Unnecessary "else" after "return" (no-else-return)
src/somemodule/commands.py:102:8: C0103: Variable name "p2" doesn't conform to snake_case naming style (invalid-name)
src/somemodule/commands.py:123:4: C0103: Variable name "p" doesn't conform to snake_case naming style (invalid-name)
src/somemodule/commands.py:139:0: C0111: Missing function docstring (missing-docstring)
src/somemodule/commands.py:2:0: C0411: standard import "import os" should be placed before "import click" (wrong-import-order)
src/somemodule/commands.py:3:0: C0411: standard import "import sys" should be placed before "import click" (wrong-import-order)
src/somemodule/commands.py:5:0: C0411: standard import "from subprocess import Popen, PIPE" should be placed before "import click" (wrong-import-order)

这两种工具怎么会产生如此不同的结果？

Answer 1

我只是在比较

pycodestyle

和

pylint

我自己时偶然发现了这个问题。

简而言之，答案是

pycodestyle

是

pylint

的“子集”。让我引用一些基本Python工具中的一些内容：

• Pycodestyle（以前称为 PEP8）是官方 linter 工具，用于根据 PEP8 python 的样式约定检查 python 代码。
• Pylint 是一个 Python linter，它检查源代码，也充当错误和质量检查器。它比 PEP8（Python 风格指南）有更多的验证检查和选项。
  • 这是 Python 中最常用的 linting 工具。
  • 它包括以下功能：
    • 检查每条线的长度
    • 根据项目的编码标准检查变量名称的格式是否正确
    • 检查声明的接口是否真正实现。
    • ...