Convertisseur de texte Protobuf en JSON

TextProto est une représentation textuelle lisible par l'homme des messages Protocol Buffer, principalement utilisée pour les fichiers de configuration, les fixtures de test et la sortie de débogage. Contrairement au format binaire utilisé pour le transport, TextProto utilise des noms de champs et est lisible sans schéma : nom_du_champ: valeur pour les scalaires, et nom_du_champ { ... } pour les messages imbriqués. Ce n'est pas un format de sérialisation standard pour une utilisation en production, mais il est courant dans les outils internes de Google et les fichiers de configuration TensorFlow.

Le format binaire Protobuf utilise des numéros de champ (pas des noms) et l'encodage varint pour produire des messages compacts et rapides à analyser. Un équivalent JSON d'un message Protobuf est généralement 3 à 5 fois plus volumineux. Cependant, le binaire Protobuf ne s'auto-décrit pas — vous avez besoin du schéma .proto pour le décoder. JSON est auto-descriptif et lisible par l'homme. Protobuf est préféré pour les API internes à haut débit ; JSON est préféré pour les API publiques et la configuration.

Les scénarios courants incluent : la migration de fichiers de configuration de systèmes basés sur proto (TensorFlow, Bazel) vers des systèmes basés sur JSON, le débogage de messages Protobuf en les convertissant en JSON lisible, l'écriture de fixtures de test en JSON pour les systèmes qui consomment Protobuf, et l'inspection de configurations de modèles ML stockées au format TextProto. La conversion est avec perte pour les types n'ayant pas d'équivalent JSON (comme Protobuf Any ou les octets bruts), alors examinez attentivement la sortie.

Sans le schéma .proto, un convertisseur ne peut pas connaître les types de champs (int32 vs int64 vs string) ni distinguer les champs optionnels, requis et répétés à partir de la structure seule. Les champs répétés avec une seule valeur ressemblent à des champs optionnels. Les énumérations apparaissent comme des entiers sans noms symboliques. Cet outil effectue une conversion structurelle au mieux de ses capacités ; pour une utilisation en production, utilisez le mappage JSON officiel de protoc avec le schéma disponible.