Repolode
Enviar
astral-sh

astral-sh/ruff

Um linter e formatador de código Python extremamente rápido, escrito em Rust, com mais de 900 regras e formatação compatível com Black.

Alternativa open source a:BlackFlake8

Ver no GitHubSite
Estrelas
50,197
Forks
2,534
Issues abertas
2,220
Último commit
há 9 horas

O que é?

Ruff é um linter e formatador de código Python escrito em Rust. Ele verifica erros, problemas de estilo e padrões desatualizados, além de corrigir muitos deles automaticamente. Foi criado para substituir uma combinação de ferramentas como Flake8 e seus plugins, Black, isort, pydocstyle e pyupgrade, executando tudo com um único comando e uma configuração compartilhada.

O linter inclui mais de 900 regras, muitas delas reimplementações nativas em Rust de plugins populares do Flake8. As regras são ativadas por meio de pyproject.toml, ruff.toml ou .ruff.toml, e um conjunto padrão funciona sem configuração. O cache integrado ignora arquivos que não foram alterados desde a última execução.

Ruff pode ser instalado via pip, uv, pipx, Homebrew e Conda, e inclui integrações com editores, como uma extensão para VS Code, hooks de pre-commit e uma GitHub Action. Sua configuração oferece descoberta hierárquica, adequada a monorepos.

Recursos principais

  • 01Analisa código Python com mais de 900 regras, muitas delas reimplementações de plugins do Flake8
  • 02Formata código com um formatador compatível com Black
  • 03Corrige automaticamente muitos dos problemas detectados usando --fix
  • 04Armazena resultados em cache para ignorar arquivos inalterados
  • 05Pode ser configurado por meio de pyproject.toml ou ruff.toml, com descoberta hierárquica de configurações

Casos de uso

  • Substituir Flake8, Black e isort em um projeto Python por uma única ferramenta
  • Executar verificações de lint e formatação como hook de pre-commit ou na CI
  • Analisar rapidamente um monorepo grande com configurações por diretório
  • Receber feedback no editor e aplicar correções automáticas no VS Code e em outros editores

Início rápido

  1. 1

    Instale o Ruff com uv (recomendado)

    uv tool install ruff@latest
  2. 2

    Instale o Ruff com pip

    pip install ruff
  3. 3

    Analise todos os arquivos do diretório atual

    ruff check
  4. 4

    Formate todos os arquivos do diretório atual

    ruff format

Tópicos

#python#linter#code-formatter#static-analysis#rust#flake8#devtools#pep8#python3#ruff

Perguntas frequentes

O que é ruff?
Um linter e formatador de código Python extremamente rápido, escrito em Rust, com mais de 900 regras e formatação compatível com Black. Ruff é um linter e formatador de código Python escrito em Rust. Ele verifica erros, problemas de estilo e padrões desatualizados, além de corrigir muitos deles automaticamente. Foi criado para substituir uma combinação de ferramentas como Flake8 e seus plugins, Black, isort, pydocstyle e pyupgrade, executando tudo com um único comando e uma configuração compartilhada.
ruff é gratuito? Qual é a licença?
ruff é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ruff ainda é mantido?
Manutenção ativa. O último commit de ruff foi em 21 de out. de 2026.
Para que posso usar ruff?
Substituir Flake8, Black e isort em um projeto Python por uma única ferramenta Executar verificações de lint e formatação como hook de pre-commit ou na CI Analisar rapidamente um monorepo grande com configurações por diretório Receber feedback no editor e aplicar correções automáticas no VS Code e em outros editores
Como instalar ruff?
Instale o Ruff com uv (recomendado): uv tool install ruff@latest Instale o Ruff com pip: pip install ruff Analise todos os arquivos do diretório atual: ruff check Formate todos os arquivos do diretório atual: ruff format
Onde consigo ruff?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/astral-sh/ruff

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

Projetos relacionados