YAML Biçimlendirici ve Doğrulayıcı

Ne işe yarar

YAML okunması kolay olduğu için yapılandırma dosyalarında yaygındır: Kubernetes manifestleri, GitHub Actions ve GitLab CI iş akışları, Docker Compose, Ansible playbook’ları, OpenAPI belgeleri. Ancak bozulması da kolaydır: tek bir yanlış girinti, bir sekme karakteri, kapatılmamış bir tırnak ya da iki noktadan sonra eksik bir boşluk dosyanın anlamını değiştirebilir veya yüklenmesini engelleyebilir.

Bu doğrulayıcı YAML’ınızı ayrıştırır ve her sözdizimi hatasını satır ve sütunuyla, ayrıca bilinmeyen yönergeler gibi uyarıları bildirir. YAML geçerliyse belge sayısını ve her belgenin kök değer türünü gösterir; tutarlı girintiyle düzgünce yeniden biçimlendirilmiş bir kopya da sunabilir.

Nasıl kullanılır

1. YAML’ı girdi alanına yapıştırın, bir .yaml veya .yml dosyası yükleyin ya da Örnek’e tıklayın.
2. Sonuç siz yazdıkça görünür: yeşil bir Geçerli YAML rozeti ya da Satır 3, sütun 2 gibi hatalar listesi.
3. Düzenli bir kopya için Biçimlendirilmiş YAML’ı göster açık kalsın; 2 veya 4 boşluk girinti seçin. Bloğun üstündeki düğmeyle kopyalayın.
4. Yinelenen anahtarlar hatadır seçeneğini yalnızca araçlarınız tekrar eden anahtarlara izin veriyorsa kapatın.

Sık yapılan hatalar

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• Tutarsız girinti: aynı düzeydeki öğeler aynı sütunda başlamalıdır. YAML girinti için sekme karakterine izin vermez.
• İki noktadan sonra eksik boşluk: key:value bir anahtar ve değer değil, düz bir dizedir.
• Tırnaksız özel karakterler: *, &, !, %, @ veya ters tırnakla başlayan ya da : veya # içeren değerler tırnak gerektirir.
• Beklenmedik türler: yes, no, on ve off YAML 1.2’de dize, eski YAML 1.1 ayrıştırıcılarında ise mantıksal değerdir; güvenli olmak için tırnak içine alın. 1.10 gibi sürüm numaraları tırnaksız yazılırsa 1.1 sayısına dönüşür.

Yapıyı doğrulama

Bu araç sözdizimini, yani metnin iyi biçimlendirilmiş YAML olup olmadığını denetler. Bir dosyanın doğru anahtarlara ve değer türlerine sahip olduğunu kontrol etmek için onu YAML’dan JSON’a aracıyla dönüştürün ve sonucu JSON Schema Doğrulayıcı ile doğrulayın.