google/yapf

Что это?

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

• 01Форматирует файлы Python в соответствии с готовым или пользовательским стилем, например pep8 или google.
• 02Позволяет настраивать стиль с помощью десятков параметров в конфигурационных файлах или через командную строку.
• 03Может форматировать только заданные диапазоны строк в файле.
• 04Поддерживает шаблоны исключения файлов в командной строке, а также в .yapfignore / pyproject.toml.
• 05Режим diff возвращает ненулевой код выхода, если требуется изменить форматирование, что подходит для проверок в CI.
• 06Можно использовать как инструмент командной строки или библиотеку Python.

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

• Поддержание единого стиля кода в команде или репозитории на Python.
• Добавление проверки форматирования в CI-пайплайн с помощью режима diff.
• Форматирование только строк, затронутых патчем или изменением в интеграции с редактором.
• Автоматическая очистка стиля в скриптах, которые генерируют или преобразуют код Python.

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

1. 1

   Установите YAPF из PyPI

   pip install yapf
2. 2

   Запустите yapf для файлов Python, используя такие параметры, как --diff или --in-place

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

• !В README YAPF описывается как бета-версия, и выпуски могут часто меняться.
• !Некоторые новые возможности Python, такие как синтаксис параметров типов из PEP 695 и формализация f-строк из PEP 701, пока не поддерживаются.

В подборках

Темы

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

Что такое yapf?

Форматтер Python-кода, который приводит исходные файлы к настраиваемому стилю с помощью алгоритма компоновки clang-format. YAPF форматирует исходный код Python, подбирая компоновку, соответствующую выбранному стилю. Благодаря этому разработчикам не приходится тратить столько времени на ручную правку отступов, пробелов и переносов строк. В основе YAPF лежит алгоритм переформатирования из clang-format; его можно запускать из командной строки или использовать как библиотеку через функции FormatCode и FormatFile.

yapf можно использовать бесплатно? Какая у него лицензия?

yapf распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

yapf всё ещё поддерживается?

Активно поддерживается. Последний коммит в yapf — 30 окт. 2026 г..

Для чего можно использовать yapf?

Поддержание единого стиля кода в команде или репозитории на Python. Добавление проверки форматирования в CI-пайплайн с помощью режима diff. Форматирование только строк, затронутых патчем или изменением в интеграции с редактором. Автоматическая очистка стиля в скриптах, которые генерируют или преобразуют код Python.

Как установить yapf?

Установите YAPF из PyPI: pip install yapf Запустите yapf для файлов Python, используя такие параметры, как --diff или --in-place

Где скачать yapf?

Исходный код и инструкции по установке — на GitHub: https://github.com/google/yapf