Repolode
Enviar
yoheimuta

yoheimuta/protolint

Um linter extensível com correção automática que aplica regras de estilo para Protocol Buffer sem exigir o compilador protoc.

Ver no GitHub
Estrelas
697
Forks
65
Issues abertas
53
Último commit
há 15 dias

O que é?

protolint analisa e corrige arquivos .proto tanto em proto2 quanto em proto3. Ele analisa os arquivos diretamente, sem chamar o compilador protobuf, por isso as verificações são rápidas e não exigem um ambiente completo de compilação. A maioria das regras do guia de estilo oficial pode ser corrigida com a flag -fix, e o modo de desativação automática pode inserir comentários de supressão em vez de fazer alterações que quebrariam a compatibilidade da API.

As regras podem ser desativadas em linha com comentários protolint:disable ou configuradas em um arquivo .protolint.yaml. Regras de lint personalizadas podem ser carregadas como plugins. A saída pode ser formatada para GitHub Actions, Azure DevOps, GitLab CI, JUnit, SARIF, SonarQube e outras ferramentas.

protolint pode ser executado como CLI independente, plugin do protoc, hook de pre-commit, biblioteca Go, pacote npm ou Python, ou servidor MCP para clientes de IA.

Recursos principais

  • 01Analisa arquivos proto2 e proto3 sem exigir protoc.
  • 02Corrige automaticamente a maioria das violações do guia de estilo oficial com -fix.
  • 03O modo de desativação automática insere comentários de supressão para preservar a compatibilidade da API.
  • 04Oferece suporte a comentários de desativação em linha e à configuração por .protolint.yaml.
  • 05Carrega regras personalizadas por meio de uma arquitetura de plugins.
  • 06Oferece formatadores de saída para JUnit, SARIF, SonarQube, JSON e sistemas de CI.

Casos de uso

  • Aplicar padrões consistentes de nomenclatura e indentação aos schemas protobuf de uma equipe.
  • Executar verificações de estilo em pipelines de CI ou hooks de pre-commit antes de fazer merge.
  • Analisar arquivos protobuf em editores como VS Code, IntelliJ ou Vim.
  • Adicionar regras de lint específicas do projeto para convenções internas de API.

Tópicos

#protobuf#linter#proto3#code-style#cli#golang#ci-cd#fixer#lint#plugin-architecture

Perguntas frequentes

O que é protolint?
Um linter extensível com correção automática que aplica regras de estilo para Protocol Buffer sem exigir o compilador protoc. protolint analisa e corrige arquivos .proto tanto em proto2 quanto em proto3. Ele analisa os arquivos diretamente, sem chamar o compilador protobuf, por isso as verificações são rápidas e não exigem um ambiente completo de compilação. A maioria das regras do guia de estilo oficial pode ser corrigida com a flag -fix, e o modo de desativação automática pode inserir comentários de supressão em vez de fazer alterações que quebrariam a compatibilidade da API.
protolint é gratuito? Qual é a licença?
protolint é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
protolint ainda é mantido?
Manutenção ativa. O último commit de protolint foi em 7 de out. de 2026.
Para que posso usar protolint?
Aplicar padrões consistentes de nomenclatura e indentação aos schemas protobuf de uma equipe. Executar verificações de estilo em pipelines de CI ou hooks de pre-commit antes de fazer merge. Analisar arquivos protobuf em editores como VS Code, IntelliJ ou Vim. Adicionar regras de lint específicas do projeto para convenções internas de API.
Onde consigo protolint?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yoheimuta/protolint

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

Projetos relacionados