مبدل JSON به YAML

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

تبدیل JSON به YAML داده‌ها را از JavaScript Object Notation به YAML Ain't Markup Language منتقل می‌کند. هر دو فرمت ساختارهای داده‌ای یکسانی (اشیاء، آرایه‌ها، رشته‌ها، اعداد، بولین‌ها، null) را نمایش می‌دهند، اما نحو متفاوتی دارند. JSON به آکولاد، براکت و کاما متکی است. YAML از تورفتگی و خط جدید استفاده می‌کند و خروجی‌ای تولید می‌کند که به متن ساده نزدیک‌تر است. برخلاف XML، هیچ‌کدام از این فرمت‌ها نیازی به schema ندارند.

YAML به‌عنوان یک فرمت سریال‌سازی داده انسان‌پسند طراحی شده است. این فرمت، زبان پیش‌فرض پیکربندی برای Kubernetes manifests، Docker Compose، Ansible playbooks، GitHub Actions workflows و بسیاری از سیستم‌های 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))"

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