Точка с запятой в конце инструкции не требуется. В Python символ ; используют для разделения нескольких инструкций в одной строке, но обычно каждую инструкцию записывают отдельно.
Отступ не соответствует принятому формату: используется количество пробелов, не кратное четырем, или табуляция. В текущей конфигурации каждый уровень вложенности должен составлять ровно четыре пробела.
Конструкция except: перехватывает исключения всех типов, в том числе KeyboardInterrupt и SystemExit. Из-за этого может быть сложно прервать выполнение программы, а важные ошибки могут остаться незамеченными. Перехватывайте исключения конкретных типов. Используйте except Exception, только если действительно необходимо обработать широкий набор обычных ошибок.
Блок except только повторно возбуждает перехваченное исключение с помощью raise и не выполняет никаких других действий. Такой блок try/except не приносит пользы. Удалите try/except либо добавьте обработку исключения - например, логирование или преобразование в исключение другого типа.
В блоке try больше операторов, чем допускает настройка. В данном примере максимальное количество - семь. Оставляйте в блоке try только те операции, которые могут вызвать исключение, обрабатываемое в соответствующем except. Это поможет точнее определить, на каком участке кода произошла ошибка.
Обработчик перехватывает слишком общий тип исключения, например Exception или BaseException. Из-за этого он может скрыть ошибки, которые код не должен обрабатывать. Указывайте конкретные типы исключений, с которыми умеет работать обработчик.
В обычной строке используется обратная косая черта (), за которой следует последовательность, не распознаваемая Python как управляющая последовательность. Например, \d в регулярном выражении. Python сохранит такую последовательность, но выдаст предупреждение SyntaxWarning. Чтобы избежать предупреждения, используйте raw-строки с префиксом r - например, r«…» - или экранируйте обратную косую черту (\). Для путей и регулярных выражений обычно удобнее использовать raw-строки.
В байтовой строке используется Unicode escape-последовательность, например \N{…} или \uXXXX. Если требуется получить Unicode-символ, используйте обычную строку без префикса b. Если обратную косую черту нужно сохранить как обычный символ, используйте raw-строку с префиксом rb или экранируйте ее (\).
Используется имя, характерное для примеров кода в документации, например foo, bar или baz. Такие имена не отражают назначение переменных/функций/методов и затрудняют понимание кода. Замените имя на более информативное, соответствующее назначению переменной, функции или класса. Например: total, file_path, student_names.
В модуле отсутствует docstring - строка документации в тройных кавычках, расположенная в начале файла и кратко описывающая его назначение. Добавьте docstring в качестве первой инструкции модуля.
У функции или метода отсутствует docstring — строка документации в тройных кавычках, которая кратко описывает назначение функции, её основные действия и, при необходимости, входные и возвращаемые значения. Добавьте docstring сразу после объявления функции или метода.
Длина строки превышает установленный лимит. В текущей конфигурации он составляет 79 символов. Разбейте выражение на несколько строк, используя скобки, или вынесите часть выражения в отдельную переменную. Отдельные строки с URL могут быть исключены из проверки настройкой ignore-long-lines.
В одной строке записано несколько инструкций, разделенных символом ;, либо тело if, while и другого управляющего оператора размещено в той же строке. Перенесите инструкции на отдельные строки и оформите блоки с соответствующими отступами.
Импорты должны располагаться в следующем порядке:
Внутри каждой группы сортируйте импорты по алфавиту. Проверка включена в текущую конфигурацию.
Импорты из одной группы, например из стандартной библиотеки, должны располагаться рядом. Не разделяйте их импортами из других групп.
Импорт расположен после обычного кода - например, после определения функции или выполнения инструкции. Все импорты должны находиться в начале модуля: сразу после его docstring и до основного кода.
В условии сравнения используется «магическое» значение - литерал без поясняющего имени. Из-за этого назначение значения может быть непонятно из контекста. Вынесите его в именованную константу или используйте элемент Enum, чтобы сделать смысл значения очевидным.
Между методами класса должна быть одна пустая строка.
Перед определением функции или класса на уровне модуля должны быть две пустые строки.
Между блоками кода слишком много пустых строк. На уровне модуля допускается не более двух пустых строк подряд, внутри класса - не более одной.
После декоратора не должно быть пустых строк. Объявление функции должно следовать сразу за декоратором.
После определения функции или класса верхнего уровня оставьте две пустые строки перед следующим объявлением верхнего уровня.
Перед объявлением вложенной функции или класса должна быть одна пустая строка.
Когнитивная сложность функции превышает допустимый порог - 15. Эта метрика оценивает, насколько сложно проследить логику выполнения функции. На нее влияют количество ветвлений, глубина вложенности условий и циклов, а также сложность логических выражений. Чтобы снизить когнитивную сложность: - Разделите большую функцию на несколько небольших. - Вынесите сложные условия в переменные с понятными именами. - Используйте ранний выход (return или continue), чтобы уменьшить вложенность. - Упрощайте логические выражения и по возможности избегайте глубокой вложенности.