تحويل YAML إلى JSON
حوّل مستندات YAML إلى JSON.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
ما هو YAML، ولماذا تحوّله إلى JSON؟
YAML هي لغة الإعدادات في البنية التحتية الحديثة. تعبّر عن البنى نفسها التي يعبّر عنها JSON، من خرائط وتسلسلات وقيم مفردة، لكن بالإزاحة بدل الأقواس، واقتباس اختياري، وتعليقات، وميزات مثل المراسي والأسماء المستعارة التي تتيح إعادة استخدام كتلة في مكان آخر من المستند. إنها مريحة في الكتابة، وللأسباب نفسها سهلة الخطأ بطرق خفية.
والتحويل إلى JSON يحسم ذلك كله في بنية صريحة: تُوسَّع المراسي، وتصبح الأنواع الضمنية محددة، وكل نص يُقتبس. وهذا مفيد تحديدًا لأنه يزيل الالتباس؛ فترى بالضبط ما سيسلمه المحلل لتطبيقك، بما في ذلك هل قُرئت version: 1.10 كرقم، وهل أصبحت enabled: no قيمة منطقية بدلًا من الكلمة "no".
لماذا أنشأنا هذه الأداة
يحوّل المطورون YAML إلى JSON لتغذية الشيفرة بالإعدادات، أو لفحص ما يحتويه ملف تعريف فعلًا بعد حل الأسماء المستعارة، أو لتمرير مستند عبر أدوات لا تقبل إلا JSON، أو لفحص تعريف خط تكامل مستمر قبل دفع تعديل كان سيفشل.
وتلك الملفات ترسم خريطة بنيتك التحتية، ولصقها في محوّل على الإنترنت يكشف تلك الخريطة لشخص آخر. أداتنا تحلل YAML بالكامل في المتصفح بمحلل JavaScript، فلا يُرسل شيء ولا توجد نسخة خارج تبويبك. لا حد لحجم المستند ولا حساب، وبعد تحميل الصفحة تستمر الأداة في العمل دون شبكة، وهذا بالضبط حين تكون غالبًا تتتبع إعدادات معطوبة.
نصائح وأخطاء شائعة
- انتبه للقيم ذات الأنواع الضمنية؛ فكلمة
noدون اقتباس تصل كـfalseفي JSON. - المراسي والأسماء المستعارة تُوسَّع أثناء التحويل، فقد ينتج ملف YAML مدمج مستند JSON أكبر بكثير.
- ملفات YAML متعددة المستندات، المفصولة بثلاث شرطات، لا تتحول إلى مستند JSON واحد.
- خطأ التحليل الذي يسمّي سطرًا يكون عادةً مشكلة إزاحة قبله ببضعة أسطر.
بداية سريعة: استخدام تحويل YAML إلى JSON
- الصق مستند YAML في مربع الإدخال أعلاه.
- شغّل التحويل؛ وخطأ التحليل سيسمّي السطر الذي كسره.
- اقرأ ناتج JSON وتأكد أن الأنواع كما قصدت.
- انتبه لأرقام الإصدارات والأوقات وقيم yes/no التي تغيّر نوعها.
- انسخ JSON أو نزّله لاستخدامه في شيفرتك.
حوّل في الاتجاه المعاكس بأداة تحويل JSON إلى YAML، أو جمّل النتيجة بأداة منسّق JSON.
لماذا تحوّل YAML إلى JSON
YAML مريحة في الكتابة والقراءة، ولهذا تستخدمها إعدادات كثيرة. لكن معظم لغات البرمجة وواجهات الويب تعمل مع JSON أصلًا. والتحويل يسد الفجوة: استمر في الكتابة بـ YAML المقروءة، ثم حوّل إلى JSON حين تطلبه أداة أو واجهة. ويساعد أيضًا في تتبع الأخطاء، فرؤية الإعدادات كـ JSON تزيل أي التباس حول كيف حُلِّلت YAML فعلًا.
راقب كيف تُفسَّر YAML
يكشف التحويل بالضبط كيف قرأت YAML ملفك، وهذا يفاجئ الناس أحيانًا:
- تحويل الأنواع. الكلمات
yesوnoوtrueوonوoffدون اقتباس تصبح قيمًا منطقية في JSON. و007قد تصبح الرقم7. وإذا خرجت قيمة كـtrueأو كرقم مقصوص وأنت قصدت نصًا، فقد كانت YAML تحتاج إلى اقتباس. - أخطاء الإزاحة. تعتمد YAML على المسافات للبنية. وإذا جاء التداخل خاطئًا في JSON، فإزاحة المصدر غير متسقة، وغالبًا بسبب علامة جدولة شاردة أو مسافة زائدة أو ناقصة.
- النصوص متعددة الأسطر والمراسي ميزات في YAML لا توجد في JSON؛ ويوسّعها المحوّل إلى مكافئات JSON عادية.
ورؤية JSON كثيرًا ما تكون أسرع طريقة لالتقاط خطأ في YAML لم تستطع رؤيته في الأصل.
تحقق من الناتج
بعد التحويل، تأكد أن JSON سليم البنية بأداة مدقق JSON، واجعله مقروءًا بأداة منسّق JSON لتتحقق أن البنية تطابق ما قصدته.
استخدامات شائعة
- تغذية شيفرة تتوقع JSON بإعدادات YAML.
- إرسال بيانات إعدادات عبر واجهة API.
- تتبع كيف تُحلَّل YAML بفحص JSON الناتج.
- التحويل بين أدوات تفضّل صيغًا مختلفة.