YAML'dan JSON'a

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

YAML'dan JSON'a dönüşüm, YAML (YAML Ain't Markup Language) ile yazılmış verileri JSON'a (JavaScript Object Notation) dönüştürür. Her iki format da yapılandırılmış verileri anahtar-değer çiftleri, diziler ve iç içe nesneler olarak temsil eder; ancak sözdizimi farklıdır. YAML girintileme ve minimum noktalama işareti kullanırken, JSON süslü parantez, köşeli parantez ve zorunlu tırnaklama kullanır. Farklı formatlar bekleyen sistemler arasında yapılandırma verileri aktarırken iki format arasında dönüşüm yaygın bir görevdir.

YAML insan okunabilirliği için tasarlanmıştır. Yorumları, çok satırlı dizgeleri, anchor ve alias yapılarını destekler; bunların hiçbiri JSON'da mevcut değildir. YAML'ı JSON'a dönüştürdüğünüzde bu YAML'a özgü özellikler çözümlenir: anchor'lar satır içi olarak genişletilir, yorumlar atılır ve çok satırlı bloklar kaçış karakterli dizgelere dönüşür. Çıktı, herhangi bir JSON ayrıştırıcısının okuyabileceği geçerli JSON'dur.

YAML 1.2 spesifikasyonu, JSON'u açıkça YAML'ın bir alt kümesi olarak tanımlar; yani her geçerli JSON belgesi aynı zamanda geçerli bir YAML belgesidir. Tersi doğru değildir. Yorum, anchor veya karmaşık anahtar kullanan YAML belgeleri için doğrudan JSON karşılığı yoktur ve dönüşüm sırasında basitleştirilmeleri gerekir. Bu araç dönüşümü otomatik olarak gerçekleştirir ve geçerli YAML girişinden temiz, düzgün biçimlendirilmiş JSON üretir.

YAML 1.2 Specification — yaml.org →

Neden Çevrimiçi YAML'dan JSON'a Dönüştürücü Kullanılır?

YAML'ı elle JSON'a dönüştürmek, özellikle derin iç içe yapılar veya çok satırlı değerler söz konusu olduğunda hata yaratmaya açıktır. Tarayıcı tabanlı bir dönüştürücü sonucu anında verir ve YAML sözdizimi hatalarını uygulamanıza ulaşmadan yakalar.

YAML'dan JSON'a Kullanım Senaryoları

YAML'dan JSON'a Tür Eşleme Referansı

Her YAML veri türü dönüşüm sırasında belirli bir JSON türüne eşlenir. Aşağıdaki tablo her YAML yapısını JSON çıktısıyla birlikte gösterir. Bu eşlemeleri anlamak, YAML verilerinizin dönüşüm sonrasında nasıl görüneceğini tahmin etmenize ve boolean veya null değerler gibi türlerle ilgili sürprizlerden kaçınmanıza yardımcı olur.

YAML ve JSON Sözdizimi

YAML ve JSON aynı veri modelini temsil eder; ancak farklı sözdizimi kuralları kullanır. Aşağıdaki farklar, yorumlar ve anchor'lar gibi bazı YAML özelliklerinin neden JSON karşılığı olmadığını açıklar.

Kod Örnekleri

Aşağıda YAML'ı programatik olarak JSON'a dönüştürmek için çalışan örnekler verilmiştir. Her örnek bir YAML dizgesini ayrıştırır ve biçimlendirilmiş JSON çıktısı üretir.

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

Sıkça Sorulan Sorular