pydocstyle打印调试信息

Question

我刚刚用pip在windows中安装了pydocstyle：

python -m pip install pydocstyle

现在，当我使用如下命令运行它时：

pycodestyle "Z:/path/to/my/file.py"

它打印出一大堆调试信息，如下所示：

LA2PC018 2019-04-02 14:08:58,726 DEBUG   | got_newline: True
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | parsing definition list, current token is tk.DEDENT ()
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | parsing definition list, current token is tk.NAME (_docs)
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | got_newline: True
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | parsing definition list, current token is tk.OP (+=)
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | parsing definition list, current token is tk.STRING ('"""\n')
LA2PC018 2019-04-02 14:08:58,726 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,727 DEBUG   | parsing definition list, current token is tk.NEWLINE (
)
LA2PC018 2019-04-02 14:08:58,727 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,727 DEBUG   | parsing definition list, current token is tk.NL (
)
LA2PC018 2019-04-02 14:08:58,727 DEBUG   | got_newline: True
LA2PC018 2019-04-02 14:08:58,727 DEBUG   | parsing definition list, current token is tk.NAME (return)
LA2PC018 2019-04-02 14:08:58,729 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,729 DEBUG   | parsing definition list, current token is tk.NAME (_docs)
LA2PC018 2019-04-02 14:08:58,729 DEBUG   | got_newline: False
LA2PC018 2019-04-02 14:08:58,729 DEBUG   | parsing definition list, current token is tk.NEWLINE (
)

有没有一种方法可以抑制这种情况并只获取输出？我似乎不知何故它是在调试模式下运行，但我看不到这是怎么发生的。你知道吗

我用的是3.0.0版。你知道吗

$ pydocstyle --version
3.0.0

Answer 1

您有一个设置-d/ debug选项的配置文件。pydocstyle将在您检查的文件的目录中查找配置文件，并在每个父目录直至根目录中查找配置文件。你知道吗

在listed supported filenames中查找文件，并使用找到的第一个支持的名称：

setup.cfg
tox.ini
.pydocstyle
.pydocstyle.ini
.pydocstylerc
.pydocstylerc.ini
.pep257

如果该文件有pydocstyle或pep257节，则使用它。默认情况下，搜索也会在父目录中继续，结果也会合并，请参见Inheritance。你知道吗

在该进程的某个地方，找到了debug = True配置条目，该设置导致了这种噪声级别。你知道吗

或者找到那些文件和那一行来禁用它，或者使用 config选项来指定另一个要用于配置的文件。那个文件可以是空的。你知道吗

如果您在查找配置文件时遇到问题，那么您可以运行pydocstyle debug "Z:/path/to/my/file.py"（因此用 debug启动），并且该工具将打印出每个目录的配置文件，如果它正在查找配置文件，以及它已找到的文件。你知道吗

也就是说，在您的具体案例中似乎还有更多的事情，pydocstyle显式配置输出处理程序，使其仅使用日志消息的levelname和message参数。您的输出还包含一个日期时间戳和一个LA2PC018前缀，这表示其他的东西仍在添加更多的日志配置。这表明可能正在导入一个非标准模块，该模块恰好提供了足够的匹配功能，可以继续工作，但它还使用其他处理程序配置日志框架。你知道吗

如果您使用python -v -m pydocstyle "Z:/path/to/my/file.py"运行该工具，它将产生更多输出；这会将import ...日志输出与为这些导入加载的文件一起添加。仔细检查一下，看看是否有任何超出标准库、超出site-packages的内容被导入，而不是_frozen_importlib*对象。你知道吗