Repolode
Предложить
peterjc

peterjc/flake8-black

Плагин для flake8 запускает black в режиме проверки и сообщает о различиях форматирования как о нарушениях BLK.

Открыть на GitHub
Звёзды
167
Форки
11
Открытые issues
3
Последний коммит
4 дня назад

Что это?

flake8-black — это плагин для flake8, который запускает black в режиме проверки во время линтинга. Файлы, которые black отформатировал бы заново, отмечаются нарушением BLK100. Так проверки стиля black можно выполнять той же командой flake8, что и остальные проверки.

Плагин пригодится в git-хуках pre-commit и в CI: один запуск flake8 охватывает и форматирование black, и другие проверки. Плагин читает настройки black, например target_version, skip_string_normalization и line_length, из pyproject.toml и поддерживает параметр --black-config для указания общего файла конфигурации. Внутренние ошибки, например недоступные для чтения файлы или некорректный TOML, также отмечаются кодами BLK9xx.

В README указано, что плагин не учитывает настройки include и exclude в black, поэтому файлы, исключённые из black, нужно также исключить в flake8. Рекомендуется закрепить конкретную версию black: обновления black могут приводить к появлению новых нарушений BLK100.

Ключевые возможности

  • 01Отмечает файлы, которые black отформатировал бы заново, как нарушения flake8 BLK100.
  • 02Читает настройки black, например line_length и target_version, из pyproject.toml.
  • 03Поддерживает параметр --black-config для указания общего файла конфигурации.
  • 04Отмечает внутренние проблемы, например недоступные для чтения файлы или некорректный TOML, кодами BLK9xx.
  • 05Можно установить из PyPI или conda-forge.

Сценарии использования

  • Запускать проверки стиля black вместе с другими правилами flake8 в CI.
  • Обеспечивать единообразное форматирование с помощью git-хука pre-commit.
  • Использовать общую конфигурацию black в нескольких проектах на Python.

Быстрый старт

  1. 1

    Установите плагин из PyPI с помощью pip

    pip install flake8-black
  2. 2

    Запустите flake8 для файла Python, чтобы увидеть коды BLK

    flake8 example.py

Что важно знать

  • Плагин не учитывает настройки include и exclude в black, поэтому эти файлы нужно отдельно исключить в flake8.
  • Как указано в README, версии начиная с 0.3.7 не работают с black 25.9.0. Выпуск v0.4.0, который должен исправить эту проблему, пока ожидается.

В подборках

Линтеры и форматировщики кода

Темы

#python#flake8#linting#code-style#black#formatter

Частые вопросы

Что такое flake8-black?
Плагин для flake8 запускает black в режиме проверки и сообщает о различиях форматирования как о нарушениях BLK. flake8-black — это плагин для flake8, который запускает black в режиме проверки во время линтинга. Файлы, которые black отформатировал бы заново, отмечаются нарушением BLK100. Так проверки стиля black можно выполнять той же командой flake8, что и остальные проверки.
flake8-black можно использовать бесплатно? Какая у него лицензия?
flake8-black распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
flake8-black всё ещё поддерживается?
Активно поддерживается. Последний коммит в flake8-black — 3 нояб. 2026 г..
Для чего можно использовать flake8-black?
Запускать проверки стиля black вместе с другими правилами flake8 в CI. Обеспечивать единообразное форматирование с помощью git-хука pre-commit. Использовать общую конфигурацию black в нескольких проектах на Python.
Как установить flake8-black?
Установите плагин из PyPI с помощью pip: pip install flake8-black Запустите flake8 для файла Python, чтобы увидеть коды BLK: flake8 example.py
Где скачать flake8-black?
Исходный код и инструкции по установке — на GitHub: https://github.com/peterjc/flake8-black

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты