محول Protobuf النصي إلى JSON

TextProto هو تمثيل نصي قابل للقراءة البشرية لرسائل Protocol Buffer، يُستخدم بشكل أساسي لملفات التكوين، وأدوات الاختبار، ومخرجات التصحيح. على عكس تنسيق السلك الثنائي المستخدم للنقل، يستخدم TextProto أسماء الحقول وهو قابل للقراءة بدون مخطط: field_name: value للقيم المفردة، و field_name { ... } للرسائل المتداخلة. إنه ليس تنسيق تسلسل قياسي للاستخدام الإنتاجي ولكنه شائع في أدوات Google الداخلية وملفات تكوين TensorFlow.

يستخدم تنسيق Protobuf الثنائي أرقام الحقول (وليس الأسماء) وتشفير varint لإنتاج رسائل موجزة وسريعة التحليل. يكون مكافئ JSON لرسالة Protobuf أكبر عادةً بمقدار 3-5 مرات. ومع ذلك، فإن Protobuf الثنائي ليس ذاتي الوصف - فأنت بحاجة إلى مخطط .proto لفك تشفيره. JSON ذاتي الوصف وقابل للقراءة البشرية. يُفضل Protobuf لواجهات برمجة التطبيقات الداخلية ذات الإنتاجية العالية؛ ويُفضل JSON لواجهات برمجة التطبيقات العامة والتكوين.

تشمل السيناريوهات الشائعة: ترحيل ملفات التكوين من الأنظمة المستندة إلى proto (TensorFlow، Bazel) إلى الأنظمة المستندة إلى JSON، وتصحيح رسائل Protobuf عن طريق التحويل إلى JSON قابل للقراءة، وكتابة أدوات الاختبار بتنسيق JSON للأنظمة التي تستهلك Protobuf، وفحص تكوينات نماذج التعلم الآلي المخزنة بتنسيق TextProto. التحويل فاقد للأنواع التي ليس لها مكافئ JSON (مثل Protobuf Any أو البايتات الخام)، لذا راجع المخرجات بعناية.

بدون مخطط .proto، لا يمكن للمحول معرفة أنواع الحقول (int32 مقابل int64 مقابل string) أو التمييز بين الحقول الاختيارية والإلزامية والمكررة من الهيكل وحده. تبدو الحقول المكررة ذات القيمة الواحدة متطابقة مع الحقول الاختيارية. تظهر التعدادات كأرقام صحيحة بدون أسماء رمزية. تقوم هذه الأداة بإجراء تحويل هيكلي بأفضل جهد؛ للاستخدام الإنتاجي، استخدم تعيين JSON الرسمي لـ protoc مع توفر المخطط.