حوّل JSON إلى YAML!

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

حوّل JSON إلى YAML!

يحوّل هذا JSON إلى YAML قائم على الإزاحة. تختفي الأقواس المعقوصة ومعظم علامات الاقتباس، ما يجعل صيانة النتيجة يدويًا كملف إعدادات أسهل، ويبقى ترتيب المفاتيح تمامًا كما في JSON المصدر.

يفيد حين تنقل موردًا جلبته بـ kubectl get -o json إلى manifest، أو تلصق إعدادات تلقيتها من API في docker-compose.yml أو application.yml أو workflow في GitHub Actions.

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

  1. الصق JSON في خانة JSON. الصيغة غير الصالحة تُظهر JSON parsing failed في النتيجة؛ مرّره أولًا عبر مدقق JSON عند الحاجة.
  2. راجع YAML تحت النتيجة. الإزاحة مسافتان.
  3. انسخه إلى ملف .yml، مع تعديل عمق الإزاحة إن كنت تضعه داخل كتلة أخرى.

مثال

المدخلات (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
المخرجات (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

تحتفظ السلسلة "on" بعلامتي الاقتباس: لو كُتبت مجردة على شكل on لقرأها محلّل YAML 1.1 كقيمة منطقية true. ويحوي GREETING سطرًا جديدًا، فيُخرج ككتلة |- تُظهر كل سطر كما كُتب.

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

  • يتبع الاقتباس YAML 1.1. السلاسل مثل yes وno وon وoff وy وn و~ وnull، وما يشبهها مثل "0777" أو "1.0" أو "2024-01-01"، تُقتبس حتى يقرأ PyYAML (1.1) والمحللات الحديثة 1.2 القيمة نفسها.
  • السلاسل مثل 22:22، التي قد يقرؤها YAML 1.1 كعدد بالأساس 60، تُقتبس أيضًا، ما يجنّب خطأً كلاسيكيًا في ربط المنافذ في docker-compose.
  • السلاسل متعددة الأسطر تصبح كتل |- حرفية.
  • لا تُطوى السلاسل الطويلة أبدًا (لا حد لعرض السطر).
  • تبقى المصفوفات والكائنات الفارغة على شكل [] و{}.

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

من مخرجات kubectl بصيغة JSON إلى manifest

حوّل Deployment أو ConfigMap مسحوبًا من الـ cluster بصيغة JSON، واحذف حقولًا مثل status وmetadata.uid، فيصبح لديك manifest جاهز لـ Git.

كتابة application.yml في Spring Boot

كتلة الخصائص التي تلقيتها كـ JSON من خادم إعدادات أو من الوثائق تصبح هرمية YAML، فلا تضطر إلى إزاحة مفاتيح مثل spring.datasource.url يدويًا.

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

  • لا تُولَّد تعليقات ولا anchors (&) ولا aliases (*)؛ والكائن المكرر في JSON يتكرر في YAML.
  • الأعداد الصحيحة الأكبر من 9007199254740991 تفقد دقتها بسبب حد الأرقام في JavaScript؛ أبقِ المعرّفات الطويلة سلاسل نصية في JSON.
  • الناتج مستند واحد. لملف متعدد الموارد مفصول بـ ---، حوّل كل مورد واجمعها بنفسك.

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

لماذا تُقتبس بعض السلاسل ولا تُقتبس أخرى؟

لا تُضاف علامات الاقتباس إلا حيث كانت القيمة المجردة ستُقرأ كنوع آخر. nginx:1.27 سلسلة نصية في الحالتين، لكن on و010 و22:22 تتحول إلى قيم منطقية أو أرقام في بعض المحللات، فتُقتبس.

هل يمكنني تطبيق الناتج على Kubernetes مباشرة؟

البنية صالحة كما هي. لكن مخرجات kubectl get -o json تحمل حقولًا يملؤها الخادم مثل status وresourceVersion وmanagedFields، ومن الأفضل حذفها قبل التطبيق.

هل يمكنني التبديل إلى إزاحة بأربع مسافات؟

لا يوجد خيار لذلك؛ فهي ثابتة على مسافتين، وهو الاصطلاح المستخدم في وثائق Kubernetes وdocker-compose وGitHub Actions.