YAML إلى TOML

متى يتداخل YAML و TOML ومتى لا يتداخلان

يهدف كل من YAML و TOML إلى أن يكونا صيغتين لإعدادات قابلة للقراءة من قبل البشر. يتداخلان بشكل كبير في البيانات التي يمكنهما تمثيلها (الخرائط، التسلسلات، القيم العددية)، لكنهما يختلفان في البنية وفي حالات حافة قليلة. يدعم YAML الوسوم والمراسي والقيم العددية متعددة الأسطر؛ ويميز TOML بين الجداول السطرية ومصفوفات الجداول، ويعامل التواريخ كنوع من الدرجة الأولى.

محول YAML إلى TOML هو الأكثر فائدة عند ترحيل ملف إعدادات من الصيغة المفضلة لأداة ما إلى صيغة أداة أخرى: على سبيل المثال، نقل بيان Kubernetes إلى مقتطف pyproject.toml، أو إعادة صياغة جرد Ansible في جدول [dependencies] الخاص بـ Cargo.

ما ينجو من التحويل

تصبح الخرائط (key: value في YAML) جداول TOML أو أزواج مفتاح/قيمة حسب السياق. تصبح التسلسلات مصفوفات سطرية أو ترويسات [[array.of.tables]]. تُحفظ القيم العددية ما دامت تُرسم بشكل نظيف: السلاسل والأعداد الصحيحة والأعداد العائمة والقيم المنطقية وتواريخ ISO.

ما لا ينجو

تُسطَّح مراسي YAML وأسماؤه المستعارة أثناء التحليل؛ يحتوي TOML المحوّل على القيمة الملموسة في كل موضع اسم مستعار، وهو ما يريده معظم المستهلكين. وسوم !!binary في YAML غير محفوظة لأن TOML لا يملك مكافئًا لها. تُحذف التعليقات عمدًا -- لا تضمن أي من الصيغتين الحفاظ على الرحلة ذهابًا وإيابًا.

نصائح سير العمل

قبل إيداع TOML المحوّل، شغّل مدقق TOML لمشروعك (taplo, toml-check, إلخ). المحول يترجم البنية فقط، لا الأسلوب؛ المدقق يلتقط مشاكل الاقتباس والإزاحة وترتيب المفاتيح التي لا يستطيع المحول اكتشافها.