Repolode
PyCQA

PyCQA/autoflake

Ferramenta de linha de comando que usa pyflakes para remover imports e variáveis não utilizados do código Python.

Estrelas
954
Forks
100
Issues abertas
54
Último commit
anteontem

O que é?

autoflake limpa arquivos-fonte Python removendo imports e variáveis que o pyflakes identifica como não utilizados. Por padrão, remove apenas imports não utilizados da biblioteca padrão, pois outros módulos podem ter efeitos colaterais que tornam insegura a remoção automática. A remoção de variáveis não utilizadas e a expansão de imports com curinga são opções que precisam ser ativadas.

Além de remover imports não utilizados, a ferramenta pode remover instruções pass inúteis e chaves duplicadas em dicionários. Ela pode editar arquivos ou diretórios diretamente, exibir diffs ou funcionar como uma verificação que retorna um código de erro quando há alterações a fazer. As configurações podem ser armazenadas em pyproject.toml ou setup.cfg, e há um hook para pre-commit.

Linhas marcadas com um comentário noqa não são alteradas, e um arquivo pode ser totalmente ignorado com um comentário skip_file no início.

Recursos principais

  • 01Remove imports não utilizados; por padrão, limita-se à biblioteca padrão.
  • 02Pode remover variáveis não utilizadas com uma flag opcional.
  • 03Oferece edição direta, saída de diff e modo de verificação para CI.
  • 04Remove instruções pass inúteis e chaves duplicadas em dicionários.
  • 05Pode ser configurada por pyproject.toml ou setup.cfg e se integra ao pre-commit.

Casos de uso

  • Limpar imports que sobraram antes de fazer commit de código Python.
  • Verificar imports não utilizados em um pipeline de CI.
  • Limpar em lote uma base de código Python legada de grande porte.
  • Remover imports de módulos de terceiros que podem ser descartados com segurança, usando a opção --imports.

Início rápido

  1. 1

    Instalar autoflake pelo PyPI

    pip install --upgrade autoflake
  2. 2

    Remover diretamente de um arquivo as importações e variáveis não utilizadas

    autoflake --in-place --remove-unused-variables example.py

Antes de usar

  • Por padrão, ele remove apenas as importações não utilizadas da biblioteca padrão; para outros módulos, é necessária a opção --imports.

Em coleções

Tópicos

Perguntas frequentes

O que é autoflake?
Ferramenta de linha de comando que usa pyflakes para remover imports e variáveis não utilizados do código Python. autoflake limpa arquivos-fonte Python removendo imports e variáveis que o pyflakes identifica como não utilizados. Por padrão, remove apenas imports não utilizados da biblioteca padrão, pois outros módulos podem ter efeitos colaterais que tornam insegura a remoção automática. A remoção de variáveis não utilizadas e a expansão de imports com curinga são opções que precisam ser ativadas.
autoflake é gratuito? Qual é a licença?
autoflake é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
autoflake ainda é mantido?
Manutenção ativa. O último commit de autoflake foi em 4 de nov. de 2026.
Para que posso usar autoflake?
Limpar imports que sobraram antes de fazer commit de código Python. Verificar imports não utilizados em um pipeline de CI. Limpar em lote uma base de código Python legada de grande porte. Remover imports de módulos de terceiros que podem ser descartados com segurança, usando a opção --imports.
Como instalar autoflake?
Instalar autoflake pelo PyPI: pip install --upgrade autoflake Remover diretamente de um arquivo as importações e variáveis não utilizadas: autoflake --in-place --remove-unused-variables example.py
Onde consigo autoflake?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/PyCQA/autoflake

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

Projetos relacionados