Содержание
python-formatting-guide
Предупреждения Pylint (W)
W0301: Unnecessary semicolon (unnecessary-semicolon)
Точка с запятой в конце инструкции не требуется. В Python символ ; используют для разделения нескольких инструкций в одной строке, но обычно каждую инструкцию записывают отдельно.
W0311: Bad indentation. Found %s %s, expected %s (bad-indentation)
Отступ не соответствует принятому формату: используется количество пробелов, не кратное четырем, или табуляция. В текущей конфигурации каждый уровень вложенности должен составлять ровно четыре пробела.
W0702: No exception type(s) specified (bare-except)
Конструкция except: перехватывает исключения всех типов, в том числе KeyboardInterrupt и SystemExit. Из-за этого может быть сложно прервать выполнение программы, а важные ошибки могут остаться незамеченными. Перехватывайте исключения конкретных типов. Используйте except Exception, только если действительно необходимо обработать широкий набор обычных ошибок.
W0706: The except handler raises immediately (try-except-raise)
Блок except только повторно возбуждает перехваченное исключение с помощью raise и не выполняет никаких других действий. Такой блок try/except не приносит пользы. Удалите try/except либо добавьте обработку исключения - например, логирование или преобразование в исключение другого типа.
W0717: try clause contains 8 statements, expected at most 7 (too-many-try-statements)
В блоке try больше операторов, чем допускает настройка. В данном примере максимальное количество - семь. Оставляйте в блоке try только те операции, которые могут вызвать исключение, обрабатываемое в соответствующем except. Это поможет точнее определить, на каком участке кода произошла ошибка.
W0718: Catching too general exception %s (broad-exception-caught)
Обработчик перехватывает слишком общий тип исключения, например Exception или BaseException. Из-за этого он может скрыть ошибки, которые код не должен обрабатывать. Указывайте конкретные типы исключений, с которыми умеет работать обработчик.
W1401: Anomalous backslash in string: '%s'. String constant might be missing an r prefix. (anomalous-backslash-in-string)
В обычной строке используется обратная косая черта (), за которой следует последовательность, не распознаваемая Python как управляющая последовательность. Например, \d в регулярном выражении. Python сохранит такую последовательность, но выдаст предупреждение SyntaxWarning. Чтобы избежать предупреждения, используйте raw-строки с префиксом r - например, r«…» - или экранируйте обратную косую черту (\). Для путей и регулярных выражений обычно удобнее использовать raw-строки.
W1402: Anomalous Unicode escape in byte string: '%s'. String constant might be missing an r or u prefix. (anomalous-unicode-escape-in-string)
В байтовой строке используется Unicode escape-последовательность, например \N{…} или \uXXXX. Если требуется получить Unicode-символ, используйте обычную строку без префикса b. Если обратную косую черту нужно сохранить как обычный символ, используйте raw-строку с префиксом rb или экранируйте ее (\).
Соглашения Pylint (C)
C0104: Disallowed name "%s" (disallowed-name)
Используется имя, характерное для примеров кода в документации, например foo, bar или baz. Такие имена не отражают назначение переменных/функций/методов и затрудняют понимание кода. Замените имя на более информативное, соответствующее назначению переменной, функции или класса. Например: total, file_path, student_names.
C0114: Missing module docstring (missing-module-docstring)
В модуле отсутствует docstring - строка документации в тройных кавычках, расположенная в начале файла и кратко описывающая его назначение. Добавьте docstring в качестве первой инструкции модуля.
C0116: Missing function or method docstring (missing-function-docstring)
У функции или метода отсутствует docstring — строка документации в тройных кавычках, которая кратко описывает назначение функции, её основные действия и, при необходимости, входные и возвращаемые значения. Добавьте docstring сразу после объявления функции или метода.
C0301: Line too long (%s/%s) (line-too-long)
Длина строки превышает установленный лимит. В текущей конфигурации он составляет 79 символов. Разбейте выражение на несколько строк, используя скобки, или вынесите часть выражения в отдельную переменную. Отдельные строки с URL могут быть исключены из проверки настройкой ignore-long-lines.
C0321: More than one statement on a single line (multiple-statements)
В одной строке записано несколько инструкций, разделенных символом ;, либо тело if, while и другого управляющего оператора размещено в той же строке. Перенесите инструкции на отдельные строки и оформите блоки с соответствующими отступами.
C0411: %s should be placed before %s (wrong-import-order)
Импорты должны располагаться в следующем порядке:
- Модули стандартной библиотеки.
- Сторонние пакеты.
- Модули проекта.
Внутри каждой группы сортируйте импорты по алфавиту. Проверка включена в текущую конфигурацию.
C0412: Imports from package %s are not grouped (ungrouped-imports)
Импорты из одной группы, например из стандартной библиотеки, должны располагаться рядом. Не разделяйте их импортами из других групп.
C0413: Import "%s" should be placed at the top of the module (wrong-import-position)
Импорт расположен после обычного кода - например, после определения функции или выполнения инструкции. Все импорты должны находиться в начале модуля: сразу после его docstring и до основного кода.
Рефакторинг Pylint (R)
R2004: Consider using a named constant or an enum instead of '%s'. (magic-value-comparison)
В условии сравнения используется «магическое» значение - литерал без поясняющего имени. Из-за этого назначение значения может быть непонятно из контекста. Вынесите его в именованную константу или используйте элемент Enum, чтобы сделать смысл значения очевидным.
flake8
E301: expected 1 blank line, found 0 (expected-1-blank-line)
Между методами класса должна быть одна пустая строка.
E302: expected 2 blank lines, found N (expected-2-blank-lines)
Перед определением функции или класса на уровне модуля должны быть две пустые строки.
E303: too many blank lines (too-many-blank-lines)
Между блоками кода слишком много пустых строк. На уровне модуля допускается не более двух пустых строк подряд, внутри класса - не более одной.
E304: blank lines found after function decorator (blank-lines-after-decorator)
После декоратора не должно быть пустых строк. Объявление функции должно следовать сразу за декоратором.
E305: expected 2 blank lines after class or function definition (expected-2-blank-lines-after-definition)
После определения функции или класса верхнего уровня оставьте две пустые строки перед следующим объявлением верхнего уровня.
E306: expected 1 blank line before a nested definition (expected-1-blank-line-before-nested-definition)
Перед объявлением вложенной функции или класса должна быть одна пустая строка.
CCR001: Cognitive complexity is too high (SCORE > 15) (cognitive-complexity-is-too-high)
Когнитивная сложность функции превышает допустимый порог - 15. Эта метрика оценивает, насколько сложно проследить логику выполнения функции. На нее влияют количество ветвлений, глубина вложенности условий и циклов, а также сложность логических выражений. Чтобы снизить когнитивную сложность: - Разделите большую функцию на несколько небольших. - Вынесите сложные условия в переменные с понятными именами. - Используйте ранний выход (return или continue), чтобы уменьшить вложенность. - Упрощайте логические выражения и по возможности избегайте глубокой вложенности.
