حوّل مستندات JSON إلى TOML مع مسافة بادئة قابلة للتكوين وخيارات طباعة جميلة.
حوّل مستندات JSON إلى TOML مع مسافة بادئة قابلة للتكوين وخيارات طباعة جميلة. حوّل مستندات JSON إلى TOML مع مسافة بادئة قابلة للتكوين وخيارات طباعة جميلة.
JSON موجود في كل مكان على الشبكة، لكن TOML هو التنسيق الذي تستخدمه معظم ملفات الإعدادات الحديثة فعليًا (Cargo وpyproject.toml وGitHub Actions وuv وغيرها الكثير). عندما تنسخ مقتطف JSON من واجهة API إلى ملف إعدادات، عليك عادةً ترجمة الصياغة يدويًا: الأقواس المعقوفة تصبح أقسامًا، والأقواس المربعة تصبح مصفوفات، والفواصل تصبح أسطرًا جديدة، والمفاتيح المقتبسة تصبح مفاتيح مجردة.
المحول يؤتمت هذه الترجمة بحيث يمكنك لصق استجابة واجهة API ونسخ إخراج TOML وتنتهي المهمة.
معظم المحولات تحافظ على ترتيب كائنات JSON افتراضيًا. TOML يسمح لك بإعادة ترتيب الأقسام، لذا فإن خيار "فرز المفاتيح" يساعد عندما تريد مقارنة مستقرة بين عمليات التشغيل. التحكم في المسافة البادئة يتيح لك مطابقة دليل الأنماط للمشروع (مسافتان أو أربع مسافات).
بالنسبة لمصفوفات الجداول في TOML، يصدر المحول الشكل المضمّن
key = [ ... ] عندما تحتوي مصفوفة JSON على كائن واحد موحد،
وشكل رأس [[section]] للقوائم التي تخلط الأنواع
أو تكرر نفس المخطط. هذه هي الحالة الوحيدة التي يكون فيها
التحويل غير ميكانيكي بالكامل.
قبل إيداع TOML، تحقق مرتين من أن المفاتيح التي استخدمتها في JSON هي مفاتيح TOML مجردة قانونية (بدون مسافات، بدون أرقام بادئة، بدون شرطات في البداية). المحول يحافظ على الأسماء كما هي؛ لا يعيد تسميتها. بعد التحويل، الصقها في محررك وشغّل مدقق المشروع لاكتشاف أي مشاكل أسلوبية لا يعرفها المحول.
تخيل أن لديك استجابة واجهة API تسرد علامات ميزات مشروعك وتريد لصقها مباشرة في كتلة pyproject.toml. يبدو JSON مثل { "name": "beetools", "features": ["json", "toml"] }. بعد التحويل يقرأ TOML name = "beetools" وfeatures = ["json", "toml"]، ويمكنك وضعه في [tool.beetools] دون مزيد من التعديل. مصفوفات الجداول ([[items]]) تأتي من مصفوفات JSON التي تكون عناصرها كائنات بمفاتيح متطابقة؛ يكتشف المحول الشكل المتجانس ويصدر الشكل متعدد الأسطر تلقائيًا. إذا رأيت إخراجًا مبسطًا بدلاً من ذلك، فإن الإدخال خلط الأنواع -- قسّم المصدر يدويًا وأعد التشغيل.