Ruff против других инструментов

Экосистема Python-инструментов для анализа кода насчитывает десятки утилит: flake8, black, isort, pylint, mypy, pyupgrade, pydocstyle, bandit и многие другие. Каждый из них решает свою задачу, но у каждого есть недостатки — скорость, сложность настройки, конфликты между правилами, необходимость устанавливать множество плагинов.

Ruff появился как ответ на эту фрагментацию. Он объединяет большинство популярных линтеров и форматировщиков в один бинарник, работает в 10–100 раз быстрее и не требует внешних зависимостей. Но может ли он полностью заменить каждый из этих инструментов? Давайте разберёмся.

В этом уроке мы подробно сравним Ruff с каждым из основных инструментов, разберём, что Ruff заменяет полностью, что — частично, а что не заменяет вовсе. Вы узнаете, как мигрировать с existing инструментов на Ruff и как настроить его так, чтобы он максимально соответствовал вашему текущему рабочему процессу.

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

В таблице ниже приведено сравнение Ruff с основными инструментами Python-экосистемы по ключевым параметрам: функциональность, скорость, сложность настройки и степень замены в Ruff.

Скорость работы

Разница в скорости обусловлена несколькими факторами:

• Язык реализации: Ruff на Rust, остальные — на Python. Rust-бинарник запускается напрямую, без интерпретатора.
• Параллелизм: Ruff обрабатывает файлы в несколько потоков, используя все ядра CPU.
• Объединённый AST: Ruff строит одно AST и прогоняет все правила по нему, вместо многократного парсинга.
• Кеширование: Ruff кеширует результаты между запусками.

Как видно из таблицы, Ruff покрывает функциональность flake8, black, isort, pyupgrade, bandit, pydocstyle и многих других плагинов в одном инструменте. Это означает, что вам не нужно настраивать и запускать 5–10 разных инструментов — один Ruff делает всё.

Flake8 — один из самых популярных линтеров в Python-сообществе. Он объединяет pycodestyle (PEP 8), Pyflakes (логические ошибки) и McCabe (сложность кода). Ruff полностью заменяет flake8, включая большинство популярных плагинов.

Плагины flake8, которые заменяет Ruff

Пошаговая миграция с flake8

Если в проекте есть .flake8 или секция [flake8] в setup.cfg, вот как перенести настройки в Ruff:

[flake8]
max-line-length = 100
extend-ignore = E203, W503
per-file-ignores =
    __init__.py: F401
exclude = .git,__pycache__,migrations/,vendor/
max-complexity = 12

[tool.ruff]
line-length = 100

[tool.ruff.lint]
extend-ignore = ["E203", "W503"]

[tool.ruff.lint.per-file-ignores]
"__init__.py" = ["F401"]

[tool.ruff.lint.mccabe]
max-complexity = 12

[tool.ruff]
extend-exclude = ["migrations/", "vendor/"]

Дополнительные настройки flake8 и их эквиваленты

ruff format — это форматировщик, который является «совместимой заменой» black. Это значит, что на любом проекте, отформатированном black, ruff format даст тот же результат в 99% случаев. Основные различия минимальны и касаются редких edge case.

Сходства ruff format и black

• Тот же стиль — ruff format следует тем же принципам, что и black: неизменяемый стиль, 88 символов по умолчанию, «бескомпромиссное» форматирование
• Совместимость с PEP 8 — оба инструмента следуют PEP 8 с некоторыми отклонениями (E203, W503)
• Magic trailing comma — оба используют запятые для управления вертикальным форматированием
• Стабильность — ruff format, как и black, гарантирует детерминированный вывод

Различия ruff format и black

Перенос конфигурации black

[tool.black]
line-length = 100
target-version = ["py311"]
skip-magic-trailing-comma = true

[tool.ruff]
line-length = 100
target-version = "py311"

[tool.ruff.format]
exclude = []
quote-style = "preserve"  # или "double", "single"

Ruff полностью заменяет isort через правила категории I (isort). Все основные функции isort поддерживаются: группировка импортов (стандартные библиотеки, third-party, локальные), сортировка по алфавиту, разделение на секции, known-first-party, known-third-party и другие.

Перенос конфигурации isort

[tool.isort]
profile = "black"
line_length = 100
known_first_party = ["my_project"]
known_third_party = ["django", "flask"]
sections = ["STDLIB", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER"]
skip = ["migrations/"]

[tool.ruff.lint]
select = ["I"]

[tool.ruff.lint.isort]
known-first-party = ["my_project"]
known-third-party = ["django", "flask"]
required-imports = ["from __future__ import annotations"]
extra-standard-library = ["tomllib"]

Pylint — самый старый и самый полный линтер для Python. Он умеет не только проверять стиль, но и проводить глубокий анализ кода. Ruff покрывает ~90% правил pylint, но некоторые возможности pylint остаются уникальными.

Что pylint умеет, а Ruff — нет

Ruff покрывает большинство правил pylint, но не все. Вот что pylint умеет делать лучше или что Ruff пока не поддерживает:

• Межмодульный анализ — pylint понимает связи между файлами и может, например, найти неиспользуемые публичные функции/классы в модуле (C0114, C0115, C0116). Ruff работает в рамках одного файла.
• Анализ потока управления — pylint находит недостижимый код, всегда истинные/ложные условия, зацикливания. Ruff имеет базовые проверки, но pylint глубже.
• Глубокая проверка классов и наследования — pylint проверяет корректность MRO (Method Resolution Order), сигнатуры переопределённых методов, абстрактные классы.
• Проверка строк документации — pylint проверяет не только наличие docstring, но и соответствие параметров/возвращаемых значений.
• Кастомные плагины — pylint поддерживает написание собственных плагинов на Python. Ruff не поддерживает кастомные плагины (но поддерживает более 900 встроенных правил).
• Логирование — pylint находит использование % форматирования вместо f-строк в логах, проверяет корректность вызова логгера.

Сравнение правил pylint и Ruff

Для большинства проектов Ruff более чем достаточен. Pylint оправдан в крупных проектах с высокими требованиями к качеству (например, в авиации, медицинском ПО, финансовом секторе). Если вы используете pylint в основном для проверки стиля — смело переходите на Ruff. Если же вам нужен глубокий анализ — оставьте pylint, но используйте Ruff для быстрой проверки первого уровня.

pyupgrade → Ruff (правила UP)

Pyupgrade автоматически обновляет синтаксис Python до современной версии. Ruff полностью заменяет его через правила категории UP:

# Было (старый синтаксис)
from typing import List, Optional
x: List[str] = []
y: Optional[str] = None

# После UP006, UP007 (ruff check --fix)
x: list[str] = []
y: str | None = None

# Было: with open("file") as f: content = f.read()
# После UP012 (PEP 608)
# (Ruff автоматически заменит на pathlib методы)

bandit → Ruff (правила S)

Bandit проверяет безопасность кода: SQL-инъекции, использование eval(), доступ к файловой системе и т.д. Ruff заменяет его через правила S:

# S101 — не используйте assert в production
assert user.is_admin                     # S101

# S701 — уязвимость XSS в jinja2
from jinja2 import Template
Template("{{ user_input }}").render()    # S701

# S324 — устаревший модуль
import md5                               # S324

pydocstyle → Ruff (правила D)

Pydocstyle проверяет наличие и формат docstring. Ruff поддерживает все популярные конвенции: Google, NumPy, PEP 257.

[tool.ruff.lint]
select = ["D"]         # все docstring правила

[tool.ruff.lint.pydocstyle]
convention = "google"  # или "numpy", "pep257"

autoflake → Ruff (--fix)

Autoflake удаляет неиспользуемые импорты и переменные. Ruff делает это через ruff check --fix с правилами F401, F841.

Важно понимать границы применимости Ruff. Есть задачи, которые Ruff решать не должен и не будет:

Вот рекомендуемый набор инструментов для Python-проекта любого размера:

Эта комбинация закрывает все потребности современного Python-проекта:

• Ruff check + Ruff format = 2 команды вместо 5-7
• Mypy добавляет безопасность типов
• Pytest обеспечивает качество через тестирование
• Всё вместе работает за секунды, а не минуты

Теперь вы знаете, как Ruff соотносится с другими инструментами и как мигрировать на него. В следующем уроке мы рассмотрим настройку Ruff для больших проектов: exclude, target-version, монорепо, и стратегии постепенного внедрения в legacy-проектах.