#564 · Desarrollo y configuración

Formateador de Protocol Buffers

Limpia y ordena texto de Protocol Buffers para revisar mensajes, servicios, enums y opciones con mayor claridad. El formateador aplica sangría alrededor de llaves, separa declaraciones terminadas en punto y coma y conserva comentarios y cadenas siempre que sea posible. Todo el procesamiento ocurre en el navegador y no compila el esquema ni necesita protoc.

Entrada de texto

Contenido .proto
Espacio publicitario

Cómo usar esta herramienta de texto

  1. Pega el contenido de un archivo .proto.
  2. Elige la sangría y si deseas normalizar espacios alrededor de =.
  3. Ejecuta el formateador.
  4. Revisa el resultado y compílalo después con tus herramientas habituales.

Qué hace esta herramienta

Reorganiza texto Protocol Buffers para mejorar su legibilidad. No compila, no resuelve imports y no valida números de campo o compatibilidad entre versiones.

Protege cadenas y comentarios, añade saltos tras llaves y punto y coma, y calcula la sangría según la profundidad de bloques.

La salida debe pasar por protoc o por el linter de tu proyecto antes de considerarse válida.

Ejemplo

Entrada: message Usuario{string nombre=1;}

Salida: la declaración del campo queda dentro del bloque message con sangría uniforme.

Casos de uso

  • Limpiar archivos .proto generados o copiados.
  • Preparar esquemas para revisiones de código.
  • Homogeneizar ejemplos en documentación.
  • Detectar visualmente mensajes y servicios anidados.

Consejos para obtener mejores resultados

  • No cambies manualmente números de campo durante el formateo.
  • Revisa imports y packages después del proceso.
  • Mantén comentarios de compatibilidad o deprecación.
  • Compila siempre el resultado antes de fusionarlo en una rama estable.

Detalles del procesamiento

La herramienta trabaja con reglas léxicas ligeras y no modifica el archivo de origen. Puede normalizar espacios alrededor del operador = en declaraciones sencillas.

No reemplaza protoc ni un parser oficial de protobuf; opciones complejas, literales multilínea o sintaxis futura pueden requerir ajustes manuales.

Preguntas frecuentes

¿Este formateador de Protocol Buffers valida que los números de campo sean correctos?

No. Organiza el texto, pero no verifica reutilización de tags, rangos reservados ni reglas de compatibilidad.

¿Funciona con syntax = "proto2" y syntax = "proto3"?

El formateo estructural puede usarse con ambas, aunque no valida las diferencias semánticas entre versiones.

¿Se conservan los comentarios // y /* */ del archivo .proto?

La herramienta intenta conservarlos durante el formateo. Revisa comentarios complejos o bloques inusuales antes de guardar el resultado.

¿Necesito instalar protoc para usar el formateador?

No. El formateo se realiza en el navegador. protoc solo es necesario si después quieres compilar o validar formalmente el esquema.

¿Puede formatear servicios rpc y mensajes anidados?

Sí para estructuras habituales delimitadas por llaves. Los bloques anidados reciben sangría según su profundidad.

Resumen técnico

MóduloFunción
EntradaContenido .proto
ProcesamientoProtege cadenas y comentarios, añade saltos tras llaves y punto y coma, y calcula la sangría según la profundidad de bloques.
PrivacidadProcesamiento local en el navegador
ExportaciónTXT y, cuando corresponde, CSV/JSON