محوّل JSON إلى YAML

ما هو تحويل JSON إلى YAML؟

يُحوِّل هذا المحوّل البيانات من تنسيق JavaScript Object Notation إلى تنسيق YAML Ain't Markup Language. يمثّل كلا التنسيقين بنى البيانات ذاتها (كائنات، مصفوفات، نصوص، أرقام، قيم منطقية، null)، لكنهما يعتمدان صياغتَين مختلفتَين. يعتمد JSON على الأقواس المعقوصة والمربعة والفواصل، في حين يستخدم YAML المسافات البادئة وفواصل الأسطر، مما يُنتج مخرجات أقرب إلى النص العادي. ولا يشترط أيٌّ منهما وجود مخطط بيانات على عكس XML.

صُمِّم YAML ليكون تنسيق تسلسل بيانات مناسبًا للإنسان. وهو لغة الإعداد الافتراضية لمانيفستات Kubernetes وملفات Docker Compose وكتيبات Ansible وسير عمل GitHub Actions وكثير من أنظمة CI/CD. عندما تكون بياناتك المصدر بتنسيق JSON ويتوقع نظامك المستهدف YAML، فأنت بحاجة إلى محوّل يحافظ على كل قيمة ونوع ومستوى تداخل بدقة تامة دون أي فقدان للبيانات.

يفيد تحويل JSON إلى YAML عبر الإنترنت حين تتلقى استجابات API أو بيانات مُصدَّرة بتنسيق JSON وتحتاج إلى لصقها في ملف إعداد YAML. التحويل غير مُفقِد لجميع أنواع JSON القياسية: تتوافق النصوص والأرقام والقيم المنطقية وnull والمصفوفات والكائنات مباشرةً مع مقابلاتها في YAML. وتُقتبَس القيم التي تحتوي على نقطتَين أو محارف خاصة تلقائيًا لضمان صحة مخرجات YAML.

لماذا تحوّل JSON إلى YAML؟

YAML هو المعيار لملفات الإعداد، وJSON هو ما تُعيده واجهات API. يتيح لك التحويل بينهما استخدام التنسيق الملائم لكل مهمة دون إعادة كتابة البيانات يدويًا.

حالات استخدام تحويل JSON إلى YAML

مقارنة JSON مقابل YAML

يمكن لـJSON وYAML تمثيل البيانات ذاتها، لكن صياغتهما وقدراتهما تختلفان بطرق تؤثر على حالات الاستخدام المحددة.

تحذيرات YAML بعد التحويل

يحتوي YAML على قواعد تحليل تُفاجئ المطورين القادمين من JSON. هذه المشكلات الأربع تُسبب أكثر الأخطاء شيوعًا عند العمل مع المخرجات المحوَّلة.

أمثلة برمجية

يتطلب تحويل JSON إلى YAML برمجيًا مكتبة تسلسل YAML في معظم لغات البرمجة. تتعامل المكتبة القياسية مع تحليل JSON؛ أما مخرجات YAML فتحتاج إلى حزمة إضافية.

import YAML from 'js-yaml'

const json = '{"host":"localhost","port":3000,"debug":true}'
const obj = JSON.parse(json)
const yamlStr = YAML.dump(obj, { indent: 2 })
console.log(yamlStr)
// → host: localhost
// → port: 3000
// → debug: true

import json, yaml

json_str = '{"host": "localhost", "port": 3000, "debug": true}'
data = json.loads(json_str)
yaml_str = yaml.dump(data, default_flow_style=False, sort_keys=False)
print(yaml_str)
# → host: localhost
# → port: 3000
# → debug: true

package main

import (
    "encoding/json"
    "fmt"
    "gopkg.in/yaml.v3"
)

func main() {
    jsonStr := `{"host":"localhost","port":3000,"debug":true}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    yamlBytes, _ := yaml.Marshal(data)
    fmt.Println(string(yamlBytes))
    // → debug: true
    // → host: localhost
    // → port: 3000
}

# Using yq (https://github.com/mikefarah/yq)
echo '{"host":"localhost","port":3000}' | yq -P
# → host: localhost
# → port: 3000

# Using Python one-liner
echo '{"host":"localhost","port":3000}' | python3 -c "import sys,json,yaml; print(yaml.dump(json.load(sys.stdin), default_flow_style=False))"

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