YAML

Veri Serileştirme Formatları

Veri serileştirme, yapılandırılmış verinin depolanabilir veya iletilebilir bir biçime dönüştürülmesi ve daha sonra yeniden oluşturulabilmesi sürecidir. Farklı formatlar; insan tarafından okunabilirlik, makine tarafından ayrıştırılabilirlik, ifade gücü ve dosya boyutu arasında farklı dengeler kurar. Hangi formatın seçileceği, yalnızca teknik kısıtlamalara değil; ekibin alışkanlıklarına, araç zincirine ve verinin kim tarafından tüketileceğine de bağlıdır.

JSON, YAML, TOML ve XML; yazılım geliştirmede öne çıkan dört metin tabanlı serileştirme formatıdır. Her birinin belirli bağlamlarda onu en iyi seçenek yapan güçlü yanları vardır — bu dengeleri anlamak, her iş için doğru formatı seçmenizi sağlar. Örneğin API sınırlarında JSON egemenken, altyapı otomasyonunda YAML fiili standart hâline gelmiştir.

JSON ve YAML Yan Yana

JSON ve YAML aynı veri modelini temsil eder. YAML, JSON'ın tam bir üst kümesidir — geçerli her JSON belgesi aynı zamanda geçerli bir YAML belgesidir. Aşağıda aynı yapılandırma her iki formatta da gösterilmektedir:

{
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "url": "postgres://localhost/mydb",
    "pool": 10
  }
}

server:
  host: localhost
  port: 8080
  debug: true
database:
  url: postgres://localhost/mydb
  pool: 10

YAML, süslü parantez ve köşeli parantez yerine girinti kullanır; çoğu metin değerinde tırnak işaretlerini atlar. Bu, insan tarafından düzenlenen dosyalar için daha kompakt ve okunabilir bir format sağlar, ancak girintiye duyarlılık getirir. İki format arasında geçiş yaparken bir dönüştürücü kullanmak, elle düzenlemeye kıyasla sözdizimi hatalarını büyük ölçüde azaltır.

Format Karşılaştırması

YAML Tuzakları

YAML güçlü bir format olmakla birlikte, geliştiricileri sürpriz şekilde yakalayan bilinen uç durumları vardır. En sık karşılaşılanlar şunlardır. Bu tuzakların büyük bölümü, ayrıştırıcının sizin adınıza karar vermesinden kaynaklanır; belirsiz değerleri açıkça tırnak içine almak bu sorunların çoğunu önler:

YAML'a Özgü Özellikler

Yorumlar

YAML, # karakteriyle yorum desteği sunar. Bu, yapılandırma dosyaları için JSON'a göre en büyük pratik avantajlardan biridir — ayarlarınızı satır içinde belgeleyebilirsiniz. Yorumlar kendi satırlarında veya bir değerin ardından gelebilir. Öte yandan YAML'dan JSON'a dönüştürme sırasında yorumlar kaybolur; bu nedenle yorumları korumak önemliyse YAML'ı kaynak olarak tutup yalnızca çıktı için JSON'a dönüştürün.

Çapalar ve Takma Adlar

YAML, bir düğümü &çapa-adı ile bir kez tanımlamanıza ve *çapa-adı ile istediğiniz yerde yeniden kullanmanıza olanak tanır. Bu, karmaşık yapılandırmalardaki tekrarı ortadan kaldırır. Kubernetes ve Docker Compose, paylaşılan servis tanımları için çapaları yoğun biçimde kullanır. << (birleştirme anahtarı) sözdizimini çapalarla birlikte kullanarak bir nesnenin alanlarını diğerine miras bırakmak da mümkündür.

Çok Satırlı Dizeler

YAML, iki modda blok skalerleri destekler: gerçek blok (|) satır sonlarını tam olarak korur, betikler ve şablonlar için kullanışlıdır. Katlanmış blok (>) uzun dizeleri tek bir satıra sarar, uzun düz metin açıklamaları için kullanışlıdır. Betik adımları içeren GitHub Actions iş akışları, | bloğu sayesinde çok satırlı kabuk betiklerini tek bir dize değeri olarak temiz biçimde yerleştirebildiği için bu özelliği sıklıkla kullanır.

Dönüştürmeniz Gereken Durumlar

Sık Sorulan Sorular