YAML to JSON

تبدیل YAML به JSON چیست؟

تبدیل YAML به JSON، داده‌های نوشته‌شده در YAML (YAML Ain't Markup Language) را به JSON (JavaScript Object Notation) تبدیل می‌کند. هر دو فرمت داده‌های ساختاریافته را به صورت جفت‌های کلید-مقدار، دنباله‌ها و اشیاء تودرتو نمایش می‌دهند، اما در نحو تفاوت دارند. YAML از تورفتگی و علائم نگارشی حداقلی استفاده می‌کند، در حالی که JSON از آکولاد، براکت و نقل‌قول اجباری استفاده می‌کند. تبدیل میان این دو هنگام انتقال داده‌های پیکربندی بین سیستم‌هایی که فرمت‌های متفاوتی انتظار دارند، کاری رایج است.

YAML برای خوانایی انسانی طراحی شده است. از توضیحات، رشته‌های چندخطی، لنگرها و نام‌مستعارها پشتیبانی می‌کند که هیچ‌کدام در JSON وجود ندارند. هنگامی که YAML را به JSON تبدیل می‌کنید، این ویژگی‌های اختصاصی YAML برطرف می‌شوند: لنگرها به صورت درون‌خطی گسترش می‌یابند، توضیحات حذف می‌شوند و بلوک‌های چندخطی به رشته‌های Escape‌شده تبدیل می‌شوند. خروجی، JSON معتبری است که هر تجزیه‌گر JSON می‌تواند آن را بخواند.

مشخصه YAML 1.2 به صراحت JSON را به عنوان زیرمجموعه‌ای از YAML تعریف می‌کند، به این معنا که هر سند JSON معتبر، یک سند YAML معتبر نیز هست. عکس این موضوع صحیح نیست. اسناد YAML که از توضیحات، لنگرها یا کلیدهای پیچیده استفاده می‌کنند، معادل مستقیمی در JSON ندارند و باید در حین تبدیل ساده‌سازی شوند. این ابزار آن تبدیل را به صورت خودکار انجام می‌دهد و از هر ورودی YAML معتبری، JSON تمیز و خوش‌فرمت تولید می‌کند.

YAML 1.2 Specification — yaml.org →

چرا از یک مبدل آنلاین YAML به JSON استفاده کنیم؟

تبدیل دستی YAML به JSON، به‌ویژه با ساختارهای تودرتوی عمیق یا مقادیر چندخطی، مستعد خطاست. یک مبدل مبتنی بر مرورگر نتیجه را فوری ارائه می‌دهد و خطاهای نحوی YAML را پیش از رسیدن به برنامه شما شناسایی می‌کند.

موارد استفاده YAML به JSON

جدول مرجع نگاشت انواع YAML به JSON

هر نوع داده YAML در حین تبدیل به یک نوع JSON مشخص نگاشت می‌شود. جدول زیر هر سازه YAML را در کنار خروجی JSON آن نشان می‌دهد. درک این نگاشت‌ها به شما کمک می‌کند پیش‌بینی کنید داده‌های YAML شما پس از تبدیل چگونه به نظر می‌رسند و از غافلگیری با انواعی مثل booleanها یا مقادیر null جلوگیری کنید.

نحو 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

سوالات متداول