Repolode
Enviar
yoheimuta

yoheimuta/protolint

Un linter extensible con autocorrección que aplica las reglas de estilo de Protocol Buffer sin necesitar el compilador protoc.

Ver en GitHub
Estrellas
697
Forks
65
Issues abiertos
53
Último commit
hace 15 días

¿Qué es?

protolint analiza y corrige archivos .proto de proto2 y proto3. Los analiza directamente, sin invocar el compilador de protobuf, por lo que las comprobaciones se ejecutan rápido y no requieren un entorno de compilación completo. La mayoría de las reglas oficiales de la guía de estilo se pueden corregir con la opción -fix, y el modo de desactivación automática puede insertar comentarios de supresión en lugar de hacer cambios que rompan la compatibilidad de la API.

Las reglas se pueden desactivar en línea con comentarios protolint:disable o configurar mediante un archivo .protolint.yaml. Se pueden cargar reglas de lint personalizadas como plugins. El formato de salida es compatible con GitHub Actions, Azure DevOps, GitLab CI, JUnit, SARIF, SonarQube y otras herramientas.

protolint se puede ejecutar como CLI independiente, plugin de protoc, hook de pre-commit, biblioteca de Go, paquete de npm o Python, o servidor MCP para clientes de IA.

Funciones clave

  • 01Analiza archivos proto2 y proto3 sin necesitar protoc.
  • 02Corrige automáticamente la mayoría de las infracciones de la guía de estilo oficial con -fix.
  • 03El modo de desactivación automática inserta comentarios de supresión para mantener la compatibilidad de la API.
  • 04Admite comentarios de desactivación en línea y la configuración mediante .protolint.yaml.
  • 05Carga reglas personalizadas mediante una arquitectura de plugins.
  • 06Ofrece formatos de salida para JUnit, SARIF, SonarQube, JSON y sistemas de CI.

Casos de uso

  • Aplicar convenciones coherentes de nombres e indentación en los esquemas protobuf de un equipo.
  • Ejecutar comprobaciones de estilo en pipelines de CI o hooks de pre-commit antes de integrar cambios.
  • Analizar archivos protobuf en editores como VS Code, IntelliJ o Vim.
  • Añadir reglas de lint específicas del proyecto para convenciones internas de API.

Inicio rápido

  1. 1

    Instala protolint con Homebrew

    brew install protolint
  2. 2

    Ejecuta el lint en todos los archivos .proto del directorio actual

    protolint lint .

Temas

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

Preguntas frecuentes

¿Qué es protolint?
Un linter extensible con autocorrección que aplica las reglas de estilo de Protocol Buffer sin necesitar el compilador protoc. protolint analiza y corrige archivos .proto de proto2 y proto3. Los analiza directamente, sin invocar el compilador de protobuf, por lo que las comprobaciones se ejecutan rápido y no requieren un entorno de compilación completo. La mayoría de las reglas oficiales de la guía de estilo se pueden corregir con la opción -fix, y el modo de desactivación automática puede insertar comentarios de supresión en lugar de hacer cambios que rompan la compatibilidad de la API.
¿protolint es gratuito? ¿Qué licencia tiene?
protolint es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿protolint sigue mantenido?
Mantenimiento activo. El último commit de protolint fue el 7 oct 2026.
¿Para qué puedo usar protolint?
Aplicar convenciones coherentes de nombres e indentación en los esquemas protobuf de un equipo. Ejecutar comprobaciones de estilo en pipelines de CI o hooks de pre-commit antes de integrar cambios. Analizar archivos protobuf en editores como VS Code, IntelliJ o Vim. Añadir reglas de lint específicas del proyecto para convenciones internas de API.
¿Cómo se instala protolint?
Instala protolint con Homebrew: brew install protolint Ejecuta el lint en todos los archivos .proto del directorio actual: protolint lint .
¿Dónde consigo protolint?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yoheimuta/protolint

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados