JSON ↔ YAML Dönüştürücü

Bu Araç Nedir?

YAML, çoğu modern yapılandırma dosyası için tercih edilen formattır — Kubernetes manifestleri, Docker Compose, GitHub Actions ve GitLab CI pipeline'ları, Ansible playbook'ları — çünkü dosyaları elle düzenleyen insanlar için JSON'dan daha okunaklıdır: çoğu anahtarın etrafına tırnak işareti koymaya gerek yoktur, hatalı sondaki virgüller sorun olmaz ve yorumlar desteklenir. JSON ise çoğu API'nin ve programlama dilinin doğal olarak ürettiği ve tükettiği formattır.

Bu araç, YAML spesifikasyonunun yaygın olarak kullanılan bir JavaScript uygulaması olan js-yaml kullanarak ikisi arasında köprü kurar, böylece ayrıştırma ve üretme işlemleri `kubectl` gibi YAML'a duyarlı bir aracın veya bir CI çalıştırıcısının uygulayacağı aynı kuralları izler.

JSON'u YAML'a dönüştürmek, nesneleri girintili anahtar: değer bloklarına ve dizileri `-` ön ekli liste öğelerine çevirir. YAML'ı JSON'a dönüştürmek bunun tersini yapar ve ayrıca YAML'a özgü tür kısayollarını (tırnaksız `true`, `null` veya sayılar gibi) uygun JSON türlerine çözümler.

Neden Kullanmalısınız?

• Çift yönlü — aynı ekrandan JSON'u YAML'a veya YAML'ı JSON'a dönüştürün.
• js-yaml aracılığıyla standartlara dayalı ayrıştırma ve üretim, böylece çıktı gerçek YAML araçlarının (Kubernetes, CI sistemleri, Ansible) beklediğiyle eşleşir.
• Herhangi bir derinlikte iç içe geçmiş nesneleri ve dizileri işler, YAML'ın girinti tabanlı yapısı ile JSON'un süslü ve köşeli parantezleri arasında dönüştürür.
• YAML tür kısayollarını doğru şekilde yorumlar — tırnaksız true/false, null ve sayısal değerler string yerine uygun JSON türlerine dönüşür.
• Panoya kopyalayın veya .json ya da .yaml dosyası olarak indirin.
• %100 istemci tarafında — yapıştırdığınız hiçbir şey herhangi bir yere yüklenmez.

Nasıl Kullanılır

1. Bir yön seçin: "JSON → YAML" veya "YAML → JSON".
2. Verinizi giriş kutusuna yapıştırın.
3. "Dönüştür" düğmesine tıklayın.
4. Sonucu inceleyin, ardından kopyalayın veya bir dosya kaydetmek için "İndir" düğmesine tıklayın.

Örnek

Giriş

{"name":"Alice","roles":["admin","editor"],"active":true}

Çıkış

name: Alice
roles:
  - admin
  - editor
active: true

Dizinin "roles" altında tireli bir liste haline nasıl geldiğine ve boolean değerin string "true" olmak yerine tırnaksız true olarak nasıl kaldığına dikkat edin.

Pratik ipuçları

• Bir Kubernetes manifesti veya GitHub Actions workflow'u yazmak: yapıyı önce JSON olarak taslak haline getirin (birçok editör ve yapay zeka aracı JSON'u daha güvenilir şekilde üretir), ardından son dosya için YAML'a dönüştürün.
• Sorunlu davranan bir YAML yapılandırmasını hata ayıklamak: hangi değerlerin string, sayı veya boolean olduğunu tam olarak görmek için JSON'a dönüştürün — YAML'ın esnek söz dizimi, JSON'da açıkça görülen tür uyuşmazlıklarını gizleyebilir.
• JSON'unuz özel karakterler içeren veya bir sayıyla başlayan anahtarlar içeriyorsa, js-yaml bunları YAML çıktısında otomatik olarak tırnak içine alır, böylece geri dönüşte doğru şekilde ayrıştırılırlar.

Tür dönüşümü neden YAML'ın en zorlu kısmı

YAML'ın JSON'a göre en büyük kullanılabilirlik avantajı — çoğu değerin etrafına tırnak koymayı gerektirmemesi — aynı zamanda en büyük ince hata kaynağıdır. Klasik örnek "Norveç sorunu"dur: YAML 1.1'de (birçok eski ayrıştırıcı tarafından kullanılır), tırnaksız bir `no` değeri, "no" string'i olarak değil, boolean `false` olarak yorumlanır; bu durum Norveç ülke kodunu listeleyen gerçek dünya yapılandırmalarını bozmuştur. Bu araç, boolean olarak ele alınan tırnaksız değerler kümesini yalnızca `true` ve `false` (ve büyük/küçük harf varyantları) ile sınırlayan YAML 1.2 spesifikasyonunu izler ve bu tür sürprizleri azaltır — tamamen ortadan kaldırmasa da. Bir değerin nasıl tiplendirileceğinden emin değilseniz, YAML'ınızda onu açıkça tırnak içine almak en güvenli seçimdir.

Sıkça Sorulan Sorular