Repolode
Enviar
PyCQA

PyCQA/isort

Utilitário e biblioteca Python que organiza e agrupa automaticamente as instruções de importação.

Ver no GitHubSite
Estrelas
6,962
Forks
724
Issues abertas
78
Último commit
há 8 horas

O que é?

isort organiza as instruções de importação do Python em ordem alfabética e as separa automaticamente em seções por tipo, como imports da biblioteca padrão, de terceiros e do próprio projeto. Pode ser executado pela linha de comando em arquivos individuais ou diretórios inteiros, ou chamado pelo código Python por meio das funções da biblioteca.

A ferramenta oferece a opção --diff para visualizar as alterações antes de aplicá-las e o modo --check-only, que informa quais arquivos têm imports fora de ordem — recursos úteis para hooks do pre-commit e verificações de CI. A formatação de linhas longas de imports com from conta com 12 modos configuráveis, e a ferramenta pode ser configurada para manter compatibilidade com o formatador black.

isort também oferece plugins para vários editores de texto, suporte oficial ao pre-commit e um hook do Git. Para ser executado, requer Python 3.11 ou posterior, embora possa formatar código Python 2.

Recursos principais

  • 01Organiza imports em ordem alfabética e os agrupa em seções configuráveis.
  • 02Oferece uma prévia com --diff e o modo --check-only para CI e pre-commit.
  • 03Disponibiliza 12 modos de quebra de linha para instruções de importação longas.
  • 04Oferece compatibilidade com o formatador black.
  • 05Pode ser usado pela linha de comando ou como biblioteca Python.

Casos de uso

  • Manter os imports consistentes em uma base de código Python extensa.
  • Impor a ordem dos imports na CI ou em hooks do pre-commit.
  • Organizar imports automaticamente ao salvar arquivos no editor.
  • Chamar a organização de imports em scripts ou outras ferramentas Python.

Tópicos

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

Perguntas frequentes

O que é isort?
Utilitário e biblioteca Python que organiza e agrupa automaticamente as instruções de importação. isort organiza as instruções de importação do Python em ordem alfabética e as separa automaticamente em seções por tipo, como imports da biblioteca padrão, de terceiros e do próprio projeto. Pode ser executado pela linha de comando em arquivos individuais ou diretórios inteiros, ou chamado pelo código Python por meio das funções da biblioteca.
isort é gratuito? Qual é a licença?
isort é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
isort ainda é mantido?
Manutenção ativa. O último commit de isort foi em 21 de out. de 2026.
Para que posso usar isort?
Manter os imports consistentes em uma base de código Python extensa. Impor a ordem dos imports na CI ou em hooks do pre-commit. Organizar imports automaticamente ao salvar arquivos no editor. Chamar a organização de imports em scripts ou outras ferramentas Python.
Onde consigo isort?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/PyCQA/isort

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados