YAML'dan JSON'a

Örnek dönüşüm

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com
  debug: false

staging:
  <<: *defaults
  host: staging.example.com
  debug: true

JSON (çapalar çözülmüş):

{
  "defaults": {
    "timeout": 30,
    "retries": 3
  },
  "production": {
    "timeout": 30,
    "retries": 3,
    "host": "prod.example.com",
    "debug": false
  },
  "staging": {
    "timeout": 30,
    "retries": 3,
    "host": "staging.example.com",
    "debug": true
  }
}

Tür eşlemeleri

JSON’un temsil edemediği YAML’a özgü şeyler

• Yorumlar. JSON’un standart yorum sözdizimi yoktur. Yorumlar atılır.
• Çok belgeli akışlar (--- ayırıcıları). JSON dosya başına tek belgedir; dönüştürücü birden çok olduğunda bir belgeler dizisi yayar.
• Çapalar ve takma adlar. Çözülür ve satır içi çoğaltılır.
• Karmaşık anahtarlar (dize olmayan eşleme anahtarları). JSON anahtarları dize olmalıdır; karmaşık anahtarlar dizeye dönüştürülür.

1.1 ile 1.2 tuzağı

• YAML 1.1, yes, no, on, off, y, n’yi boolean olarak ayrıştırır. Ülke kodu olarak NO sessizce false olur.
• YAML 1.2 booleanları true ve false ile sınırlar. Daha güvenli ama birçok ayrıştırıcı (PyYAML varsayılanı dâhil) hâlâ 1.1 kullanır.

Dönüştürücü 1.2 anlambilimine varsayılır ve 1.1’in sonucu değiştireceği durumda uyarır.

JSON’dan YAML’a geri gidiş-dönüş

JSON’dan YAML’a genellikle kayıpsızdır (JSON, YAML 1.2 sözdiziminin bir alt kümesidir). YAML’dan JSON’a kayıplıdır: yorumlar ve birleştirme anahtarı yapısı kaybolur. Gidiş-dönüş yapmayı planlıyorsanız, orijinal YAML’ı sürüm kontrolünde koruyun.