كيف يعمل
JSON وYAML وTOML وXML وTOON وCSV وTSV طرق مختلفة لتمثيل البيانات المنظَّمة نفسها. يهيمن JSON في واجهات API؛ وYAML وTOML شائعان في ملفات الإعداد؛ ولا يزال XML موجودًا في أنظمة كثيرة؛ وCSV/TSV هما المعيار للجداول وجداول البيانات.
تفسّر هذه الأداة صيغة المصدر التي تختارها، وتبني بنيتها الداخلية، وتعيد تسلسلها بصيغة الوجهة. ويمكنك كتابة البيانات أو لصقها، أو تحميل ملف.
تشترك جميع الصيغ في فكرة الكائنات (أزواج مفتاح-قيمة) والقوائم، لذا يحافظ التحويل على البنية طالما يمكن للوجهة التعبير عنها. وتجري العملية كلها في متصفحك.
أمثلة
{ "name": "Ada", "age": 36 }name: Ada
age: 36من JSON إلى YAML: الكائن نفسه، دون أقواس معقوفة أو علامات اقتباس، مع المسافة البادئة كبنية.name = "Ada"
age = 36{ "name": "Ada", "age": 36 }من TOML إلى JSON: تتحوّل أزواج مفتاح = قيمة إلى خصائص الكائن.حالات الاستخدام
- نقل ملف إعداد من صيغة إلى أخرى، مثلًا من JSON إلى YAML لخط أنابيب CI/CD.
- تحويل استجابة JSON لواجهة API إلى CSV لفتحها في جدول بيانات.
- الترجمة بين XML وJSON عند دمج أنظمة تتحدّث صيغًا مختلفة.
الأسئلة الشائعة
هل تُحفَظ جميع البيانات عند التحويل؟
تُحفَظ البنية والقيم، لكن بعض السمات الخاصة بصيغة ما لا يوجد لها مكافئ في أخرى: تعليقات YAML أو TOML، أو سمات XML، أو الأنواع الغنية قد تُبسَّط عند الانتقال إلى JSON.
متى يُفضَّل YAML أو TOML بدلًا من JSON؟
للإعدادات المكتوبة يدويًا. يدعم YAML وTOML التعليقات وهما أكثر قابلية للقراءة؛ أما JSON فلا يحتوي تعليقات لكنه مثالي للتبادل بين البرامج.
كيف يُحوَّل شيء ذو بنية متداخلة إلى CSV؟
يمثّل CSV جدولًا مسطّحًا، لذا يعمل على أفضل نحو مع قائمة كائنات لها المفاتيح نفسها. ويجب تسطيح البنى الشديدة التداخل، لأن الجدول لا يستطيع التعبير عن مستويات متعددة.
ما صيغة TOON؟
إنها صيغة تدوين مضغوطة موجَّهة للكائنات، مصمَّمة لكتابة البيانات المنظَّمة باختصار. وتتعامل الأداة معها كصيغة مصدر أو وجهة إضافية.