محول JSON إلى TOML
لماذا تحول ملفات إعدادات JSON إلى TOML؟
لم يتم تصميم JSON ليكون لغة لملفات الإعدادات - فهو يفتقر للتعليقات، وله صيغة معقدة للبيانات المتداخلة. يجعل TOML نفس البيانات أكثر قابلية للقراءة باستخدام عناوين [الأقسام]، وتعليقات #، وصيغة مفتاح-قيمة نظيفة. تحويل ملف config.json إلى config.toml يحسن قابلية الصيانة والتوثيق الذاتي لمشاريعك.
توليد تلقائي للأقسام
تتحول كائنات JSON المتداخلة تلقائياً إلى مسارات جداول TOML بصيغة [section.subsection].
الحفاظ على الأنواع
يتم ربط الأرقام والقيم المنطقية والنصوص في JSON بشكل صحيح مع نظيراتها في TOML دون فقدان للبيانات.
إعدادات أنظف
البيانات في TOML عادة ما تكون أقصر بنسبة 20-40% وأكثر وضوحاً من كود JSON المماثل.
كيفية تحويل JSON إلى TOML
الصق إعدادات JSON
انسخ ملف إعدادات JSON الحالي وألصقه في اللوحة اليسرى.
راجع مخرجات TOML
ستظهر لوحة اليمين كود TOML المكافئ - تحقق من تطابق الهيكل مع توقعاتك.
أضف التعليقات واحفظ
انسخ كود TOML، أضف تعليقاتك باستخدام # لتوثيق كل قسم، ثم احفظ الملف الجديد.
حالات استخدام JSON إلى TOML
إنشاء Cargo.toml
تحويل معلومات مشروع package.json إلى تنسيق Cargo.toml لتسريع تهيئة مشاريع لغة Rust.
الانتقال إلى pyproject.toml
تحويل إعدادات setup.cfg أو setup.py إلى المعيار الحديث لبيئة بايثون pyproject.toml.
ترقية ملفات الإعدادات
نقل إعدادات config.json إلى config.toml وإضافة تعليقات توضيحية لكل خيار.
مشاركة الإعدادات بين الأدوات
مشاركة نفس بيانات الإعدادات بين الأنظمة التي تفضل JSON وتلك التي تدعم TOML عبر التحويل.
نصائح تحويل JSON إلى TOML
✓ دقق مصفوفات الكائنات
تستخدم مصفوفات كائنات JSON صيغة [[array-of-tables]] في TOML. تأكد من صحة هذا التحويل في المخرجات.
✓ لا توجد قيمة null في TOML
قيمة null في JSON ليس لها ترادف مباشر في TOML. غالباً ما يتم تجاهلها أو استبدالها بنصوص فارغة.
✓ اقتباس المفاتيح ذات الرموز
المفاتيح في TOML التي تحتوي على شرطات أو مسافات يجب وضعها بين علامتي اقتباس.
✓ اختبر الكود في تطبيقك
قد تختلف طريقة معالجة بعض الحالات بين محللات TOML المختلفة. اختبر الملف دائماً في بيئة تشغيلك الفعلية.
❓ الأسئلة الشائعة
هل يمكن تحويل جميع أنواع بيانات JSON؟
معظم الأنواع تتحول بوضوح: النصوص والأرقام والمنطق والمصفوفات والكائنات. فقط قيمة null لا يدعمها TOML ويتم حذفها عادة.
هل يمكن لـ TOML استبدال JSON بالكامل؟
نعم، بالنسبة لملفات الإعدادات الساكنة. ستحتاج فقط لتغيير كود القراءة من JSON.parse() إلى مكتبة تدعم TOML. لكنه لا يستبدل JSON في تبادل بيانات الـ APIs.
ما هو الامتداد الذي يستخدمه TOML؟
يستخدم امتداد .toml. من الأمثلة الشهيرة: Cargo.toml و pyproject.toml و config.toml.
كيف أختار بين JSON و YAML و TOML؟
استخدم JSON لتبادل بيانات الـ API. استخدم YAML لإعدادات DevOps (مثل Docker و CI/CD). استخدم TOML لملفات إعدادات التطبيقات لسهولتها الكبيرة في التحرير البشري.