Repolode
asottile

asottile/add-trailing-comma

Инструмент для Python и pre-commit hook, который автоматически добавляет завершающие запятые в многострочные вызовы, литералы и определения.

Звёзды
373
Форки
28
Открытые issues
0
Последний коммит
3 дня назад

Что это?

add-trailing-comma переписывает исходные файлы Python, добавляя завершающие запятые в многострочные вызовы функций, литералы кортежей, списков, словарей и множеств, определения функций и классов, импорты from, инструкции with и варианты match. Его можно запускать как отдельную команду после установки из PyPI или как pre-commit hook, настроенный в проекте.

Инструмент также форматирует окружающие скобки в едином стиле: открывающая скобка остаётся в конце строки, каждый аргумент располагается на один уровень отступа глубже, а закрывающая скобка возвращается в начало своей строки. Он также удаляет лишние запятые из однострочных литералов. Поэтому при добавлении или удалении аргумента меняется только одна строка, и diff в системе контроля версий остаётся минимальным.

Проект поддерживает синтаксис параметров типов из PEP 695 и инструкции match; правила показаны в документации проекта на примерах diff до и после форматирования.

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

  • 01Добавляет завершающие запятые в вызовы, литералы, определения функций и классов, а также импорты.
  • 02Поддерживает инструкции with, варианты match и параметры типов из PEP 695.
  • 03Форматирует открывающие и закрывающие скобки так, чтобы каждый аргумент располагался на отдельной строке.
  • 04Удаляет лишние завершающие запятые из однострочных литералов.
  • 05Работает как pre-commit hook или как отдельная команда, устанавливаемая через pip.

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

  • Поддержание единого стиля форматирования многострочного кода во всей кодовой базе Python.
  • Сохранение минимальных diff при добавлении или удалении аргументов в длинных вызовах.
  • Автоматизация проверок форматирования в рабочем процессе pre-commit.

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

  1. 1

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

    pip install add-trailing-comma
  2. 2

    При желании добавьте его как хук pre-commit в .pre-commit-config.yaml

В подборках

Темы

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

Что такое add-trailing-comma?
Инструмент для Python и pre-commit hook, который автоматически добавляет завершающие запятые в многострочные вызовы, литералы и определения. add-trailing-comma переписывает исходные файлы Python, добавляя завершающие запятые в многострочные вызовы функций, литералы кортежей, списков, словарей и множеств, определения функций и классов, импорты from, инструкции with и варианты match. Его можно запускать как отдельную команду после установки из PyPI или как pre-commit hook, настроенный в проекте.
add-trailing-comma можно использовать бесплатно? Какая у него лицензия?
add-trailing-comma распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
add-trailing-comma всё ещё поддерживается?
Активно поддерживается. Последний коммит в add-trailing-comma — 4 нояб. 2026 г..
Для чего можно использовать add-trailing-comma?
Поддержание единого стиля форматирования многострочного кода во всей кодовой базе Python. Сохранение минимальных diff при добавлении или удалении аргументов в длинных вызовах. Автоматизация проверок форматирования в рабочем процессе pre-commit.
Как установить add-trailing-comma?
Установите инструмент с помощью pip: pip install add-trailing-comma При желании добавьте его как хук pre-commit в .pre-commit-config.yaml
Где скачать add-trailing-comma?
Исходный код и инструкции по установке — на GitHub: https://github.com/asottile/add-trailing-comma

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

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

Плагин для Vim и Neovim: асинхронно проверяет код во время набора, запускает форматтеры и исправления вроде prettier и eslint, а также работает как LSP-клиент.

14 тыс.+4 за неделю1,5 тыс.Vim ScriptBSD-2-ClauseОбновлён 18 дней назад