Утилита и библиотека для Python, которые автоматически сортируют и группируют импорты.
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
Установите инструмент с помощью pip
pip install add-trailing-comma - 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 обновляется ежедневно.
Похожие проекты
Консольная утилита и плагин для flake8, которые проверяют единообразие настроек в нескольких проектах и автоматически исправляют конфиги.
CLI-инструмент, который запускает Black для блоков кода на Python в документации Markdown, reStructuredText и LaTeX.
CLI-инструмент для запуска Python-линтеров и форматтеров, таких как ruff, isort, black, mypy и flake8, прямо в Jupyter Notebooks.
Консольная утилита для удаления неиспользуемых импортов и переменных из Python-кода с помощью pyflakes.
Плагин для Vim и Neovim: асинхронно проверяет код во время набора, запускает форматтеры и исправления вроде prettier и eslint, а также работает как LSP-клиент.