Repolode
Enviar
PyCQA

PyCQA/flake8-import-order

Plugin para flake8 e Pylama que verifica se os imports em Python estão agrupados e ordenados conforme um guia de estilo escolhido.

Ver no GitHub
Estrelas
279
Forks
72
Issues abertas
15
Último commit
há 5 dias

O que é?

flake8-import-order é um plugin de lint para flake8 e Pylama que verifica apenas o agrupamento e a ordenação de instruções de import em Python. Ele não verifica outros aspectos dos imports. Primeiro vêm os imports da biblioteca padrão, depois os pacotes de terceiros e, por fim, os pacotes locais; cada grupo é ordenado alfabeticamente, embora as regras exatas dependam do estilo selecionado.

O plugin adiciona quatro avisos: I100 e I101 para imports fora de ordem e nomes fora de ordem em um from-import; e I201 e I202 para linhas em branco ausentes ou extras entre grupos de imports. Ele inclui vários estilos prontos, como cryptography (o padrão), google, smarkets, appnexus, edited, pycharm e pep8, que exige o agrupamento, mas não a ordenação dentro dos grupos. Os projetos podem declarar seus próprios nomes de aplicações e pacotes usando opções de configuração.

É possível adicionar estilos personalizados criando subclasses de Style e registrando-as por meio de entry points do setuptools.

Recursos principais

  • 01Verifica o agrupamento e a ordenação de imports para flake8 e Pylama.
  • 02Oferece quatro códigos de aviso que cobrem problemas de ordenação e de linhas em branco.
  • 03Inclui estilos prontos, como cryptography, google, smarkets e pep8.
  • 04Permite que os projetos configurem nomes de aplicações e pacotes locais.
  • 05Oferece suporte a estilos personalizados por meio de subclasses e entry points.

Casos de uso

  • Impor um padrão consistente para a organização dos imports em uma base de código Python no CI.
  • Seguir o guia de estilo de imports de uma equipe, como o do Google, ou uma convenção específica do projeto.
  • Adicionar verificações de ordenação de imports a uma configuração existente de lint com flake8.

Antes de usar

  • Licenciado sob a LGPL-3.0, uma licença copyleft com condições para redistribuição.
  • Verifica apenas imports no escopo do módulo; imports condicionais são ignorados, exceto os que estão sob TYPE_CHECKING.
  • A ordem é verificada apenas entre imports adjacentes, portanto alguns imports fora de ordem podem não ser identificados.

Em coleções

Linters e formatadores de código

Tópicos

#python#linter#flake8#code-style#static-analysis#flake8-extensions#linter-flake8#linter-plugin#pylama

Perguntas frequentes

O que é flake8-import-order?
Plugin para flake8 e Pylama que verifica se os imports em Python estão agrupados e ordenados conforme um guia de estilo escolhido. flake8-import-order é um plugin de lint para flake8 e Pylama que verifica apenas o agrupamento e a ordenação de instruções de import em Python. Ele não verifica outros aspectos dos imports. Primeiro vêm os imports da biblioteca padrão, depois os pacotes de terceiros e, por fim, os pacotes locais; cada grupo é ordenado alfabeticamente, embora as regras exatas dependam do estilo selecionado.
flake8-import-order é gratuito? Qual é a licença?
flake8-import-order é open source sob a licença LGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
flake8-import-order ainda é mantido?
Manutenção ativa. O último commit de flake8-import-order foi em 3 de nov. de 2026.
Para que posso usar flake8-import-order?
Impor um padrão consistente para a organização dos imports em uma base de código Python no CI. Seguir o guia de estilo de imports de uma equipe, como o do Google, ou uma convenção específica do projeto. Adicionar verificações de ordenação de imports a uma configuração existente de lint com flake8.
Onde consigo flake8-import-order?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/PyCQA/flake8-import-order

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

Projetos relacionados