JSON'dan YAML'a

JSON'dan YAML'a Dönüşüm Nedir?

JSON'dan YAML'a dönüşüm, verileri JavaScript Object Notation'dan YAML Ain't Markup Language'e aktarır. Her iki format da aynı veri yapılarını (nesneler, diziler, dizgeler, sayılar, boolean'lar, null) temsil eder; ancak farklı sözdizimi kullanır. JSON süslü parantez, köşeli parantez ve virgüllere dayanır. YAML ise girintileme ve satır sonları kullanır; bu da çıktının düz metne daha yakın okunmasını sağlar. XML'in aksine, her iki format da şema gerektirmez.

YAML, insan dostu bir veri serileştirme formatı olarak tasarlanmıştır. Kubernetes manifest'leri, Docker Compose dosyaları, Ansible playbook'ları, GitHub Actions iş akışları ve pek çok CI/CD sistemi için varsayılan yapılandırma dilidir. Kaynak verileriniz JSON biçimindeyken hedef sisteminiz YAML bekliyorsa, her değeri, türü ve iç içe geçme düzeyini veri kaybı olmadan koruyan bir dönüştürücüye ihtiyacınız vardır.

JSON'dan YAML'a çevrimiçi dönüştürme, API yanıtları veya JSON olarak dışa aktarılan verileri alıp bir YAML yapılandırma dosyasına yapıştırmanız gerektiğinde oldukça kullanışlıdır. Dönüşüm, tüm standart JSON türleri için kayıpsızdır: dizgeler, sayılar, boolean'lar, null, diziler ve nesneler doğrudan YAML karşılıklarına eşlenir. İki nokta veya özel karakter içeren değerler otomatik olarak tırnak içine alınarak geçerli YAML çıktısı sağlanır.

Neden JSON'dan YAML'a Dönüştürülür?

YAML yapılandırma dosyalarının standardıdır; JSON ise API'lerin döndürdüğü formattır. Aralarında dönüşüm yaparak verileri elle yeniden yazmadan her görev için doğru formatı kullanabilirsiniz.

JSON'dan YAML'a Kullanım Senaryoları

JSON ve YAML Karşılaştırması

JSON ve YAML aynı verileri temsil edebilir; ancak sözdizimi ve yetenekleri belirli kullanım senaryoları için önem taşıyan farklılıklar içerir.

Dönüşüm Sonrası YAML Tuzakları

YAML'ın, JSON'dan gelen geliştiricileri şaşırtan ayrıştırma kuralları vardır. Bu dört sorun, dönüştürülmüş çıktıyla çalışırken en fazla hataya neden olur.

Kod Örnekleri

JSON'u YAML'a programatik olarak dönüştürmek, çoğu dilde bir YAML serileştirme kütüphanesi gerektirir. Standart kütüphane JSON ayrıştırmayı halleder; YAML çıktısı için ek bir paket gerekir.

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))"

Sıkça Sorulan Sorular