YAML ke JSON

Contoh konversi

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (anchor di-resolve):

{
  "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
  }
}

Pemetaan tipe

Hal khusus YAML yang tidak bisa direpresentasikan JSON

• Komentar. JSON tidak punya sintaks komentar standar. Komentar dibuang.
• Stream multi-dokumen (pemisah ---). JSON adalah satu dokumen per file; konverter menampilkan array dokumen saat ada beberapa.
• Anchor dan alias. Di-resolve dan diduplikasi inline.
• Key kompleks (key mapping non-string). Key JSON harus berupa string; key kompleks distringifikasi.

Jebakan 1.1 vs 1.2

• YAML 1.1 memparse yes, no, on, off, y, n sebagai boolean. NO sebagai kode negara diam-diam menjadi false.
• YAML 1.2 membatasi boolean ke true dan false. Lebih aman tetapi banyak parser (termasuk default PyYAML) masih memakai 1.1.

Konverter default ke semantik 1.2 dan memperingatkan saat 1.1 akan mengubah hasilnya.

Round trip dari JSON kembali ke YAML

JSON ke YAML biasanya lossless (JSON adalah subset dari sintaks YAML 1.2). YAML ke JSON bersifat lossy: komentar dan struktur merge-key hilang. Jika Anda berencana round trip, pertahankan YAML asli di version control.