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

PyCQA/isort

Утилита и библиотека для Python, которые автоматически сортируют и группируют импорты.

Открыть на GitHubСайт
Звёзды
6,962
Форки
724
Открытые issues
78
Последний коммит
16 часов назад

Что это?

isort сортирует импорты в Python-файлах по алфавиту и автоматически распределяет их по разделам: стандартная библиотека, сторонние пакеты и код проекта. Его можно запускать из командной строки для отдельных файлов или целых каталогов, а также вызывать функции библиотеки из Python-кода.

Параметр --diff позволяет предварительно просмотреть изменения, а режим --check-only сообщает о файлах с несортированными импортами — это удобно для pre-commit-хуков и проверок в CI. Для переносов длинных импортов from доступны 12 настраиваемых режимов; также isort можно настроить для совместной работы с форматтером black.

У isort есть плагины для разных текстовых редакторов, официальная поддержка pre-commit и Git-хук. Для запуска требуется Python 3.11 или новее, хотя форматировать можно и код для Python 2.

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

  • 01Сортирует импорты по алфавиту и распределяет их по настраиваемым разделам.
  • 02Позволяет просматривать изменения с помощью --diff и проверять сортировку в режимах CI и pre-commit с помощью --check-only.
  • 03Предлагает 12 режимов переноса длинных импортов на несколько строк.
  • 04Поддерживает совместную работу с форматтером black.
  • 05Работает из командной строки и как библиотека Python.

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

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

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

  1. 1

    Установить isort из PyPI

    pip install isort
  2. 2

    Упорядочить импорты в выбранных файлах

    isort mypythonfile.py mypythonfile2.py
  3. 3

    Рекурсивно упорядочить импорты во всём проекте

    isort .

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

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

Темы

#python#formatter#linter#code-style#imports#cli#pre-commit#auto-formatter#cleaner#hacktoberfest

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

Что такое isort?
Утилита и библиотека для Python, которые автоматически сортируют и группируют импорты. isort сортирует импорты в Python-файлах по алфавиту и автоматически распределяет их по разделам: стандартная библиотека, сторонние пакеты и код проекта. Его можно запускать из командной строки для отдельных файлов или целых каталогов, а также вызывать функции библиотеки из Python-кода.
isort можно использовать бесплатно? Какая у него лицензия?
isort распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
isort всё ещё поддерживается?
Активно поддерживается. Последний коммит в isort — 21 окт. 2026 г..
Для чего можно использовать isort?
Поддержание единообразного порядка импортов в большой кодовой базе на Python. Проверка порядка импортов в CI или pre-commit-хуках. Автоматическая сортировка импортов при сохранении файлов в редакторе. Вызов сортировки импортов из скриптов и других инструментов на Python.
Как установить isort?
Установить isort из PyPI: pip install isort Упорядочить импорты в выбранных файлах: isort mypythonfile.py mypythonfile2.py Рекурсивно упорядочить импорты во всём проекте: isort .
Где скачать isort?
Исходный код и инструкции по установке — на GitHub: https://github.com/PyCQA/isort

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

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

qltysh / qlty

Мультиъязычный CLI на Rust, который запускает линтеры, автоформаттеры, сканеры безопасности и проверки поддерживаемости кода с помощью одного инструмента и конфигурационного файла.

Инструменты разработчика#code-quality#linter#formatter
3,2 тыс.274COtherОбновлён 10 часов назад