Entrée

Sortie

Qu'est-ce que Protocol Buffers (Protobuf) ?

Protocol Buffers (Protobuf) est un format de sérialisation indépendant du langage et de la plateforme, développé par Google. Les fichiers .proto définissent le schéma des messages et services et sont largement utilisés avec les API gRPC.

Le formateur Protobuf normalise l'indentation (2 espaces par niveau), corrige l'alignement des blocs et supprime les espaces en fin de ligne — pour des fichiers .proto cohérents et lisibles. Consultez le guide de style Protobuf et le code source sur le dépôt GitHub protobuf.

Mode d'emploi

1

Collez votre contenu .proto

Collez votre schéma Protocol Buffer dans l'éditeur de gauche ou cliquez sur Téléverser pour charger un fichier .proto.

2

Formatage instantané

Le formateur corrige l'indentation (2 espaces par niveau), normalise la structure des blocs message et service et supprime les espaces en fin de ligne.

3

Copier ou télécharger

Utilisez le bouton Copier pour copier le résultat ou Télécharger pour l'enregistrer en fichier .proto.

Exemple de formatage

Exemple : Formater une définition de message proto3

Entrée non formatée :

syntax="proto3";package api;message User{string name=1;int32 age=2;repeated string roles=3;bool active=4;}

Sortie formatée :

syntax = "proto3";
package api;

message User {
  string name = 1;
  int32 age = 2;
  repeated string roles = 3;
  bool active = 4;
}

Questions fréquentes

Quelle est la différence entre proto2 et proto3 ?

Proto3 est la syntaxe plus récente et recommandée. Elle supprime les règles required/optional, simplifie les valeurs par défaut et améliore la sérialisation JSON. Le formateur prend en charge les deux versions.

Puis-je l'utiliser pour des définitions de services gRPC ?

Oui. Les définitions gRPC utilisent la syntaxe Protobuf standard avec les blocs service et rpc, que le formateur gère correctement.

Le formateur valide-t-il la syntaxe Protobuf ?

Le formateur normalise l'indentation et la structure des blocs mais n'effectue pas de validation sémantique complète. Utilisez protoc pour la compilation et la validation complètes.

Quel style d'indentation le formateur utilise-t-il pour les fichiers .proto ?

Le formateur suit le guide de style officiel Protobuf, qui recommande 2 espaces par niveau d'indentation. Les blocs imbriqués dans les déclarations message, service et enum sont tous indentés de façon cohérente.

Outils associés