حوّل YAML إلى JSON!

أدخل YAML لتحويله إلى JSON! يدعم yml, Kubernetes, docker-compose.
YAML
النتيجة
 

حوّل YAML إلى JSON!

حوّل مستند YAML (yml) إلى JSON لترى البنية التي تُخفيها الإزاحة والنوع الفعلي الذي حُلّلت إليه كل قيمة. تُوسَّع الـ anchors والـ aliases إلى قيم حقيقية، وتُجمع المستندات المتعددة المفصولة بـ --- في مصفوفة.

مفيد خصوصًا لاكتشاف أخطاء YAML الكلاسيكية: قيمة التصقت بالأب الخطأ بسبب مسافة واحدة ناقصة، أو version: 1.10 الذي يصبح بصمت الرقم 1.1.

طريقة الاستخدام

  1. الصق ملف docker-compose.yml أو manifest لـ Kubernetes أو ملف workflow في خانة YAML، أو أفلت الملف عليها.
  2. تظهر أخطاء الصيغة في النتيجة مع رقمي السطر والعمود؛ تحقق من الإزاحة في ذلك الموضع أولًا.
  3. اقرأ JSON تحت النتيجة لترى إن كانت كل قيمة قد أصبحت سلسلة نصية أو رقمًا أو قيمة منطقية، وانسخه إن احتجت إليه.

مثال

المدخلات (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
المخرجات (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

يبقى المفتاح on: في GitHub Actions مفتاحًا نصيًا "on"، لأن هذه الأداة تحلّل بقواعد YAML 1.2. وتُوسَّع الكتلة المعرَّفة بالـ anchor &node في موضع *node.

الميزات المدعومة

  • يُحلَّل بالمخطط الأساسي لـ YAML 1.2: تبقى yes وon وoff سلاسل نصية، ولا يصبح قيمًا منطقية إلا true/True/false.
  • يصبح ~ والقيم الفارغة null؛ وتصبح القيم السداسية عشرية 0x1F والثمانية 0o17 أرقامًا.
  • تُحلّ &anchors و*aliases إلى القيم المشار إليها.
  • تتحول الكتل العددية الحرفية | والمطوية > إلى سلاسل نصية مع تطبيق قواعد YAML للأسطر الجديدة.
  • تصبح المستندات المتعددة المفصولة بـ --- مصفوفة JSON؛ والمستند الواحد يُخرج كقيمته الخاصة.
  • المفتاح الذي يظهر مرتين في الـ mapping نفسه يُبلَّغ عنه كخطأ.

حالات الاستخدام

التحقق من إزاحة manifests في Kubernetes

إن كان env تحت containers مُزاحًا بمستوى أقل من اللازم، فإنه يلتصق بصمت بحقل آخر ولا تكتشف ذلك إلا عند التطبيق. في JSON تُظهر الأقواس بالضبط إلى أي كائن ينتمي.

استخدام الإعدادات من الكود

لسكربت أو حزمة واجهة أمامية تكون إضافة محلّل YAML إليها مبالغة، حوّل الإعدادات مرة واحدة واستخدمها بالشكل import config from './config.json'.

فحص مواصفات OpenAPI

مستند OpenAPI المكتوب بـ YAML أسهل في الاستعلام بـ JSONPath أو jq بعد تحويله، مثلًا لاستخراج المخطط عند مسار معين.

ملاحظات وقيود

  • تُطبَّق مفاتيح الدمج (<<: *defaults): تُنسخ مفاتيح الـ mapping المرتبط بالـ anchor، والمفاتيح المكتوبة بجانب << تتجاوزها. أما المحلّل الذي يقتصر على YAML 1.2 فيُبقي << مفتاحًا عاديًا، لذا قد تختلف النتائج عن تلك الأدوات.
  • تبقى التواريخ والأوقات مثل 2024-01-01 سلاسل نصية ولا تصبح قيم Date.
  • ليس لـ .inf و.nan تمثيل في JSON فتصبحان null.
  • لا يمكن نقل التعليقات إلى JSON فتُحذف.
  • يقرأ PyYAML (YAML 1.1) القيمتين on وyes على أنهما true، لذا قد تختلف النتائج في Python.

الأسئلة الشائعة

لماذا يظهر on في GitHub Actions على شكل "on" لا true؟

في YAML 1.2 القيم المنطقية الوحيدة هي true وfalse، فيكون on سلسلة نصية عادية، وهكذا يقرأ GitHub Actions المفتاح أيضًا. أما PyYAML في Python فيتبع 1.1 ويحوّله إلى مفتاح True، فانتبه عند تحليل ملفات workflow من السكربتات.

version: 1.10 يخرج على شكل 1.1.

1.10 غير المقتبس رقم في YAML، و1.10 يساوي 1.1. للإبقاء على سلسلة إصدار، اقتبسها في YAML المصدر بالشكل "1.10".

ماذا يحدث مع ملف يحوي عدة مستندات؟

يصبح كل مستند مفصول بـ --- عنصرًا في مصفوفة بالترتيب، لذا فإن ملفًا متعدد الموارد يُستخدم مع kubectl apply -f يُنتج مصفوفة من الموارد.