Перейти к содержанию
ERITKOM
ВебНовость

Ruff 0.17.4 исправил падение на UTF-8 BOM и расширил проверку Python

Обновление линтера уточняет диагностику, невидимые символы и цвет терминала; новые нестабильные правила остаются в preview.

Официальная плашка Made by Astral из репозитория Ruff
Charles Marsh / Astral и участники Ruff, исходник, MIT; оригинальный SVG. Изменены размер и формат, не экран новой сборки.

Невидимый префикс ломал показ ошибки

Ruff выпустил версию 0.17.4 с исправлением падения при диагностике файлов с UTF-8 BOM. BOM — служебная последовательность в начале текста, которая может быть незаметна в редакторе. Ошибка возникала не обязательно при чтении программы: сбой был связан с подготовкой фрагмента исходника для отображения сообщения линтера.

В первичном исправлении объясняется несогласованность смещений. Из буфера фрагмента удалялись три байта BOM, а отдельные аннотации сохраняли неподходящие границы. Результат выходил за новую длину фрагмента и приводил к panic. Разработчики заменили вычисление безопасным вычитанием с насыщением и добавили тесты для файлов с таким префиксом. Это исправление устойчивости диагностического инструмента, а не новая интерпретация семантики Python.

Обычные исправления и preview — разные режимы

В стабильной части уточнён разбор некоторых конструкций после точки с запятой: bare raise и идентификаторов match. Для правила SIM102 скорректировано обнаружение сворачиваемых elif после ветви if из нескольких инструкций. Такие изменения влияют на принимаемые исходники и предупреждения, но не означают автоматического переписывания каждого проекта после установки пакета.

В отдельном разделе preview указаны изменения исправлений G004, относящихся к форматированию логирования, и новое правило tarfile-ignore-zeros-true. Документация Ruff подчёркивает, что preview включается явно и может содержать нестабильные правила, исправления и стиль форматирования. Само включение режима не выбирает все новые правила: состав проверок задаётся отдельно. Поэтому доступность проверки в бинарном файле и её действие в конкретном проекте — не одно и то же.

Терминал должен показывать то, что действительно меняется

В сравнении предлагаемых исправлений теперь отображается больше непечатаемых символов. Для ревью это не декоративная мелочь: визуально похожие строки могут отличаться управляющим символом или пробельной последовательностью. Явное представление помогает понять изменение до применения исправления, не полагаясь только на внешний вид исходного текста в редакторе.

Командная строка учитывает приоритет NO_COLOR и значение CLICOLOR=0 в диагностике Ruff и ty. Эти настройки относятся к цветовому оформлению сообщений, а не к выбору правил или к формату самого Python-кода. Отключение цвета полезно при сохранении журналов и выводе через сторонние инструменты, но не исправляет ошибки приложения. Содержимое отчёта и способ его раскраски остаются разными уровнями поведения.

Оптимизации без обещанного процента

В выпуск включены изменения обхода синтаксического дерева, обработки фрагментов исходника, поиска комментариев и повторного использования квалифицированных имён. Для поиска комментариев используется фильтр Блума, а для обычной записи — конкретный буфер. Эти детали объясняют направления работы разработчиков, однако список коммитов не даёт сопоставимого процента ускорения на произвольном репозитории.

Ruff объединяет линтер и форматтер, написанные на Rust, а настройки проекта могут храниться в pyproject.toml. Проверка стиля, автоматическое исправление и запуск пользовательских тестов не взаимозаменяемы. Версия 0.17.4 меняет поведение инструмента в перечисленных случаях; она не доказывает корректность бизнес-логики проверяемой программы. Собственного тестирования скорости или массового применения исправлений к чужим проектам для этой публикации не выполнялось.

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача