من YAML إلى JSON

مثال على عملية التحويل

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com
  debug: false

staging:
  <<: *defaults
  host: staging.example.com
  debug: true

JSON (تم حل الروابط فيه):

{
  "defaults": {
    "timeout": 30,
    "retries": 3
  },
  "production": {
    "timeout": 30,
    "retries": 3,
    "host": "prod.example.com",
    "debug": false
  },
  "staging": {
    "timeout": 30,
    "retries": 3,
    "host": "staging.example.com",
    "debug": true
  }
}

تعيين الأنواع

جوانب خاصة بـ YAML لا يمكن لتنسيق JSON تمثيلها

• التعليقات: لا يحتوي تنسيق JSON على صيغة قياسية للتعليقات؛ وبالتالي تُستبعد التعليقات تلقائيًا.
• تيارات المستندات المتعددة (باستخدام علامات الفصل ---): يحتوي ملف JSON على مستند واحد لكل ملف؛ أما عند وجود عدة مستندات، فإن المحول يُنتج مصفوفة من هذه المستندات.
• المرجعيات والأسماء البديلة: تم حلها وتكرارها داخل السطر نفسه.
• المفاتيح المعقدة (مفاتيح التعيين غير النصية): يجب أن تكون مفاتيح JSON نصوصًا؛ وتُحوَّل المفاتيح المعقدة إلى نصوص.

فخ الإصدار 1.1 مقابل الإصدار 1.2

• يقوم YAML 1.1 بتحليل القيم yes، no، on، off، y، وn على أنها قيم منطقية (bool values)، بينما يتم تحويل القيمة NO تلقائيًا إلى رمز دولة وهو false دون إشعار.
• يقتصر تنسيق YAML 1.2 على القيم المنطقية من نوعين فقط هما true وfalse؛ وهو أكثر أمانًا، لكن العديد من أدوات تحليل البيانات (بما في ذلك الإعداد الافتراضي في PyYAML) ما زالت تستخدم الإصدار 1.1.

يعتمد المحول بشكل افتراضي على دلالات الإصدار 1.2، ويُصدر تنبيهًا عندما يكون استخدام الإصدار 1.1 سيؤدي إلى تغيير النتيجة.

رحلة ذهاب وإياب من JSON إلى YAML

عادةً ما يكون التحويل من JSON إلى YAML خاليًا من فقدان البيانات (حيث يُعد JSON مجموعة فرعية من صيغة YAML 1.2)، بينما يكون التحويل العكسي من YAML إلى JSON مع خسارة بيانات؛ إذ تختفي التعليقات وهيكل مفتاح الدمج. إذا كنت تخطط لإجراء هذا التحوّل ذهابًا وإيابًا، فيجب الحفاظ على النسخة الأصلية من YAML ضمن نظام التحكم بالنسخ.