печать отладочной информации pydocstyle

Question

Я только что установил pydocstyle в Windows, используя pip:

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 будет искать файл конфигурации в каталоге файла, который вы проверяли, и в каждом родительском каталоге вплоть до корня.

Ищите файл в списке поддерживаемых имен файлов , ииспользуется первое найденное поддерживаемое имя:

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

Если этот файл имеет раздел pydocstyle или pep257, он используется.По умолчанию поиск продолжается и в родительских каталогах, и результаты объединяются, см. Наследование .

Где-то в этом процессе найдена запись конфигурации debug = True,и этот параметр вызывает этот уровень шума.

Либо найдите эти файлы и эту строку, чтобы отключить их, или используйте параметр --config, чтобы указать другой файл, который будет использоваться для конфигурации.Этот файл может быть просто пустым.

Если у вас возникли проблемы с поиском файлов конфигурации, то вы могли бы запустить pydocstyle --debug "Z:/path/to/my/file.py" (поэтому начать с --debug) и инструмент распечатаетдля каждого каталога, если он находит файлы конфигурации и какие файлы он обнаружил, если он это делает.

При этом в вашем конкретном случае, похоже, происходит больше pydocstyle явно настраивает обработчики вывода, чтобы использовать только имя уровня и параметры сообщения сообщений журнала.Ваши выходные данные содержат отметку даты и времени и префикс LA2PC018, который указывает, что что-то еще все еще добавляет дополнительную конфигурацию ведения журнала.Это говорит о том, что, возможно, импортируется нестандартный модуль, который, как оказалось, предоставляет достаточно соответствующих функций для работы, но также настраивает каркас ведения журнала с дополнительными обработчиками.

Если вы запускаете инструмент с python -v -m pydocstyle "Z:/path/to/my/file.py" it 'создаст много больше продукции;это добавляет import ... вывод журнала вместе с файлами, загруженными для этих импортов.Прочесайте это, чтобы увидеть, импортируется ли что-либо за пределами стандартной библиотеки, за пределами site-packages и _frozen_importlib*.