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

psf/black

Black — форматтер Python-кода с заданным стилем и предсказуемым результатом, который перезаписывает файлы с минимальными diff.

Открыть на GitHubСайт
Звёзды
41,948
Форки
2,940
Открытые issues
298
Последний коммит
16 часов назад

Что это?

Black — форматтер Python-кода с заданным стилем. Он переформатирует файлы целиком на месте и предлагает намеренно небольшой набор параметров стиля, чтобы код выглядел одинаково в разных проектах и не возникало споров о форматировании. Black рассчитан на создание минимальных diff, благодаря чему при ревью кода можно сосредоточиться на его содержании.

Для работы Black требуется Python 3.10 или новее; установить его можно через pip. Black также умеет форматировать Jupyter Notebooks, если установить дополнительную зависимость jupyter. Для тех, кто не хочет устанавливать Python, доступны отдельные исполняемые файлы. Настройки читаются из pyproject.toml, в том числе шаблоны include и exclude, но значения по умолчанию рассчитаны на работу без изменений.

В целях безопасности Black проверяет, что после переформатирования код по-прежнему разбирается в AST, эквивалентный исходному. Флаг --fast отключает эту проверку. В проекте описаны стиль кода и политика стабильности, согласно которой изменения стиля ограничены исправлениями ошибок и поддержкой нового синтаксиса Python.

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

  • 01Переформатирует файлы Python на месте, используя небольшой фиксированный набор параметров стиля.
  • 02Создаёт минимальные diff, чтобы при ревью кода можно было сосредоточиться на его содержании.
  • 03По умолчанию проверяет эквивалентность AST отформатированного кода и исходного.
  • 04Форматирует Jupyter Notebooks при установке дополнительной зависимости jupyter.
  • 05Читает настройки проекта из pyproject.toml.

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

  • Задать единый стиль кода для команды или репозитория на Python.
  • Автоматически запускать проверку форматирования через pre-commit hook или в CI.
  • Форматировать код Python в Jupyter Notebooks наряду с обычными файлами исходного кода.

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

  1. 1

    Установите Black с помощью pip

    pip install black
  2. 2

    Отформатируйте файл или каталог

    black {source_file_or_directory}

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

  • Для запуска требуется Python версии 3.10 или новее.

Темы

#python#code-formatter#linter#pep8#developer-tools#pre-commit#autopep8#code#codeformatter#formatter

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

Что такое black?
Black — форматтер Python-кода с заданным стилем и предсказуемым результатом, который перезаписывает файлы с минимальными diff. Black — форматтер Python-кода с заданным стилем. Он переформатирует файлы целиком на месте и предлагает намеренно небольшой набор параметров стиля, чтобы код выглядел одинаково в разных проектах и не возникало споров о форматировании. Black рассчитан на создание минимальных diff, благодаря чему при ревью кода можно сосредоточиться на его содержании.
black можно использовать бесплатно? Какая у него лицензия?
black распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
black всё ещё поддерживается?
Активно поддерживается. Последний коммит в black — 19 окт. 2026 г..
Для чего можно использовать black?
Задать единый стиль кода для команды или репозитория на Python. Автоматически запускать проверку форматирования через pre-commit hook или в CI. Форматировать код Python в Jupyter Notebooks наряду с обычными файлами исходного кода.
Как установить black?
Установите Black с помощью pip: pip install black Отформатируйте файл или каталог: black {source_file_or_directory}
Где скачать black?
Исходный код и инструкции по установке — на GitHub: https://github.com/psf/black

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

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