حوّل مستندات TOML إلى JSON مع إمكانية ضبط المسافات البادئة ووضع الإخراج المضغوط.
حوّل مستندات TOML إلى JSON مع إمكانية ضبط المسافات البادئة ووضع الإخراج المضغوط. حوّل مستندات TOML إلى JSON مع إمكانية ضبط المسافات البادئة ووضع الإخراج المضغوط.
JSON هو اللغة المشتركة للويب: كل واجهة برمجية تتحدثه، وكل محرر يستطيع تظليله، ولكل لغة محلل في مكتبتها القياسية. يتميز TOML في الإعدادات التي يحررها البشر لكنه أقل دعمًا عالميًا كصيغة تبادل بيانات في زمن التشغيل. عندما تحتاج إلى إدخال إعدادات TOML في أداة تستهلك JSON فقط (ملاعب الويب، مدققات المخططات، مولّدات الأكواد، إلخ.)، ينقذك محول TOML-إلى-JSON موثوق.
التحويل بلا خسارة في الغالب لأن كلا الصيغتين معبرتان بما يكفي لتمثيل نفس البدائيات. الأنواع القليلة الخاصة بـ TOML (السلاسل متعددة الأسطر، التواريخ) تترجم إلى سلاسل نصية عادية؛ والقيم القليلة الخاصة بـ JSON (null) تترجم إلى القيمة الحرفية null في JSON، التي ليس لـ TOML ما يعادلها أصليًا.
يقدم المحول مفتاح طباعة منسقة (بمسافة بادئة 2/4 مسافات) ووضعًا مضغوطًا (سطر واحد). للملفات الكبيرة جدًا، الإخراج المضغوط أسهل بكثير للصق في نص طلب curl. زر التبديل ينقل مخرجات JSON عائدًا إلى صندوق الإدخال لتتمكن من إعادة التحرير والتصدير كـ TOML مجددًا.
بعد التحويل، تحقق من صحة JSON باستخدام مدقق مخططات (ajv, jsonschema) قبل دفعه إلى أداة في المصب. محلل TOML صارم: يرفض القيم غير المقتبسة التي تبدأ بأرقام، والجداول المضمّنة التي تحتوي تعليقات، وأخطاء شائعة أخرى. استخدم رسائل الخطأ لإصلاح المستند المصدر، لا JSON.
لنفترض أنك تحتفظ بمقتطف pyproject.toml يسرد إعدادات تشغيل أداتك تحت [tool.beetools]. لتغذية نفس الإعدادات في خط أنابيب بناء جافاسكربت يقبل JSON فقط، مرّر المقتطف عبر هذا المحول. يحافظ الإخراج على تسلسل الجداول، لذا تصبح كتلة متداخلة مثل [tool.beetools.cache] هي { "tool": { "beetools": { "cache": { ... } } } }. تتكثف المفاتيح المنقوطة إلى كائنات متداخلة في الطريق، بما يعكس كيف بنى محلل TOML المفاتيح مبدئيًا. بمجرد حصولك على JSON، تحقق منه بـ ajv أو jsonschema قبل تمريره إلى المصب -- المحول يترجم الصياغة فقط.