isort CLI
isort упорядочивает импорты Python по правилам проекта и выводит различия до записи, отделяя оформление от логики кода.
- 6 966 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI перезаписывает импорты в выбранных файлах; рекурсивный запуск может затронуть несколько каталогов проекта.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/isortОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI перезаписывает импорты в выбранных файлах; рекурсивный запуск может затронуть несколько каталогов проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Переносы длинных списков, отступы и группы импортов задаются в конфигурации isort. Агент применяет эти правила к выбранным Python-файлам, а пользователь просматривает различия через `--diff` до записи. Отдельная правка импортов упрощает ревью: она не смешивается с изменением логики программы. Утилита подходит для повторяемого шага перед ревью и поддерживает подключение к редакторам и системе проверок `pre-commit`. При использовании другого форматтера правила нужно согласовать в конфигурации проекта.
Для кого. Ревьюерам Python-кода, которые хотят отделить упорядочивание импортов от содержательных правок агента.
Подходит, если
- Агент добавил импорты, и они выбиваются из порядка, принятого в проекте.
- Разработчик отделяет форматирование от функционального изменения перед ревью.
- В нескольких Python-файлах используются разные группы импортов.
- Команда добавляет локальную проверку импортов в `pre-commit` перед созданием коммита.
Не подходит, если
- Нужно форматировать весь синтаксис Python одним инструментом.
- Требуется автоматически удалить все неиспользуемые зависимости проекта.
- Перестановку импортов собираются принять без просмотра и тестирования поведения программы.
Пример запроса к агенту
Покажи изменения порядка импортов только в измененных Python-файлах и не смешивай их с функциональными правками.Ограничения
Для запуска текущего isort нужен Python 3.11 или новее, хотя обрабатываемый код может относиться к другой версии языка. Утилита занимается импортами и не заменяет форматирование остального файла или тесты программы. Режим `--atomic` проверяет синтаксис перед записью и выключен по умолчанию из-за возможного различия версий Python. При рекурсивном запуске isort обрабатывает вложенные файлы; ограничьте каталог и просмотрите различия через `--diff` до записи.
Как отключить. Уберите isort из сценариев или настроек редактора. Уже примененные изменения импортов возвращайте через сохраненную версию файла или Git.
Частые вопросы
Как увидеть изменения без записи?
Используйте `isort mypythonfile.py --diff`.
Можно обработать несколько файлов?
Да. Передайте их пути отдельными аргументами.
Как запустить обработку каталога?
Передайте путь к каталогу. Например, `isort .` обработает текущий каталог рекурсивно.
Что проверяется с параметром `--atomic`?
isort проверяет синтаксис перед записью изменений. Корректность поведения программы нужно проверить тестами отдельно.
Работает ли isort с редактором?
Да. Для разных редакторов есть отдельные плагины.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыTach, CLI для Python, проверяет импорты отдельно от работающего приложения: архитектурные правила можно запускать в CI.
CLI превращает изменения Git в пошаговый разбор с кодом, вопросами и объяснениями от подключенного ИИ-агента
typos, CLI проверки опечаток, показывает исправления в diff; пользователь принимает имена проекта до записи изменений.
Refurb анализирует Python-код и предлагает точечные улучшения с кодами правил, пояснениями и учетом целевой версии языка.
CLI открывает правки и документы в терминале, чтобы человек оставил замечания к строкам и передал их кодовому агенту
CLI открывает локальный git diff в браузере как просмотр правок в пулл-реквесте GitHub; комментарии копируются промптом для агента
Коротко о README
Есть настройки многострочных импортов и совместимости с Black. Через `pre-commit` можно включить CLI в проверки проекта перед коммитом.