Bu modül, YAML biçimindeki yapılandırma/ayar verisini TOML formatına dönüştürür. Amaç; aynı veriyi, TOML’un daha deterministik ve okunabilir söz dizimiyle üretmektir. Dönüştürme işlemi tamamen tarayıcıda gerçekleşir ve içerik sunucuya gönderilmez.
YAML; insan-okur dostu, esnek ve geniş kullanım alanına sahip bir veri serileştirme dilidir. TOML ise özellikle konfigürasyon dosyaları için tasarlanmış, “ne görüyorsan o” tarzı daha katı ve öngörülebilir bir yapıya sahiptir. Kısacası: YAML esnekliğiyle, TOML ise netliğiyle öne çıkar.
YAML metni önce güvenli şekilde ayrıştırılarak JavaScript nesnesine çevrilir. Ardından bu nesne; primitive değerler, tablolar (nested object) ve tablolar dizisi (array of object) gibi TOML kavramlarına map edilerek çıktıya yazılır. Key sıralama, null temizleme ve güvenli mod gibi seçenekler bu aşamada uygulanır.
Bir projede YAML ile gelen ayarları TOML’a taşımak, farklı ekosistemlere uyum sağlamak (ör. Rust / Cargo, bazı modern config yaklaşımları) veya konfig dosyalarını daha stabil bir şemaya oturtmak istediğinde kullanırsın. Ayrıca “kopyala/indir” ile hızlı migrasyon sağlar.
String/number/boolean tipleri doğrudan çevrilir. Tarih benzeri değerler (YAML ayrıştırıcısı Date üretirse) RFC3339 (ISO) formatında yazılır. Düz diziler TOML array olur. Nesne dizileri TOML’da [[table]] olarak üretilir. TOML’da null olmadığı için null alanlar istersen atlanır.
Araç client-side çalıştığı için içerik sunucuya gitmez. “Güvenli Mod (JSON)” seçeneği, YAML tiplerini JSON ile sınırlayarak daha kestirilebilir bir dönüşüm sağlar. Yine de hassas anahtarları (API key, token vb.) gerçek ortamda paylaşırken genel güvenlik prensiplerini unutma.
En sık sorun, YAML girintileme (indent) ve iki nokta kullanımından gelir. Hata penceresinde satır/kolon bilgisi gösterilir. Önce “YAML Düzelt” ile formatlamayı dene. Yine sorun varsa, problemli satırı izole ederek basitleştir.
Konfig verilerini küçük ve modüler tut. Null alanları bilinçli yönet (TOML’da yok). Key’leri okunur ve stabil seç. Nesne dizilerini kullanıyorsan TOML’un [[table]] modelini benimse. Bir de: aynı dosyada hem makineye hem insana hitap etmeye çalışırken gereksiz “akıllı” tip dönüşümlerinden kaçın.
