YAML إلى JSON

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

تحويل YAML إلى JSON هو عملية تحويل البيانات المكتوبة بلغة YAML (اختصار لـ YAML Ain't Markup Language) إلى تنسيق JSON (تدوين كائنات JavaScript). يمثّل كلا التنسيقين البيانات الهيكلية على شكل أزواج مفتاح-قيمة ومتتاليات وكائنات متداخلة، غير أنهما يختلفان في الصياغة. يعتمد YAML على المسافات البادئة والترميز المحدود، بينما يستخدم JSON الأقواس المعقوفة والمربعة والاقتباسات الإلزامية. يُعدّ التحويل بين التنسيقين مهمة شائعة عند نقل بيانات الإعداد بين أنظمة تتطلب تنسيقات مختلفة.

صُمِّم YAML للقراءة البشرية. يدعم التعليقات والسلاسل متعددة الأسطر والمراسي والأسماء المستعارة، وهي ميزات لا وجود لها في JSON. عند تحويل YAML إلى JSON، تُحلَّل هذه الميزات الخاصة بـYAML: تُوسَّع المراسي بشكل مضمّن، وتُحذف التعليقات، وتصبح الكتل متعددة الأسطر سلاسل نصية مُهرَّبة. والمخرج هو JSON صالح يستطيع أي محلل JSON قراءته.

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

YAML 1.2 Specification — yaml.org →

لماذا تستخدم محوّل YAML إلى JSON هذا؟

تحويل YAML إلى JSON يدوياً عملية مرهقة وعرضة للأخطاء، خاصةً في البنى المتداخلة بعمق أو القيم متعددة الأسطر. يمنحك المحوّل في المتصفح النتيجة فوريًا ويكتشف أخطاء صياغة YAML قبل أن تصل إلى تطبيقك.

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

مرجع ربط أنواع YAML بـJSON

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

صياغة YAML مقابل JSON

يمثّل YAML وJSON نموذج البيانات ذاته لكن بقواعد صياغة مختلفة. الفوارق أدناه تشرح سبب عدم وجود ما يعادل بعض ميزات YAML — كالتعليقات والمراسي — في JSON.

أمثلة على الكود

فيما يلي أمثلة عملية لتحويل YAML إلى JSON برمجياً. كل مثال يُحلِّل سلسلة YAML ويُخرج JSON منسّقاً.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

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

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

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