YAML Doğrulayıcı neyi kontrol eder?

YAML, birçok yapılandırma dosyasının biçimidir: Docker Compose dosyaları, Kubernetes bildirimleri, GitHub Actions ve GitLab CI iş akışları, Ansible playbook'ları, OpenAPI tanımları ve sayısız uygulamanın ayarları. YAML'de girintiler anlam taşıdığı için eksik bir boşluk, yanlışlıkla eklenmiş bir sekme veya yinelenen bir anahtar, fark edilmesi zor şekillerde dosyayı bozabilir. Doğrulayıcı, YAML'nizi bir ayrıştırıcının yaptığı gibi okur ve her sorunu satır ve sütun bilgisiyle listeler.

Nasıl kullanılır?

  1. Düzenleyiciye YAML yapıştırın veya yazın.
  2. Sonuç siz yazdıkça görünür: YAML ya geçerlidir ve içerdiği belge sayısı gösterilir ya da tüm sorunlar metindeki sırasına göre listelenir.
  3. Her sorun düzenleyicide işaretlenir; hatalar kırmızı, uyarılar sarı renktedir. Düzenleyiciyi ilgili konuma kaydırmak için bir soruna, sorunu listede bulmak içinse bir işarete tıklayın.

Neleri bulur?

  • Sözdizimi hataları: Kapatılmamış tırnak işaretleri ve köşeli ayraçlar, çok az ya da fazla girintilenmiş öğeler, aynı düzeyde karıştırılmış anahtar ve liste öğesi, a: b: c gibi tek satırda iç içe geçmiş eşlemeler.
  • Yinelenen anahtarlar: Aynı eşlemede iki kez kullanılan aynı anahtar. Çoğu ayrıştırıcı değerlerden yalnızca birini sessizce korur; böylece diğer ayar kaybolur.
  • Girinti için kullanılan sekmeler: YAML, girinti için yalnızca boşluk kullanılmasına izin verir.
  • Çapa olmadan kullanılan takma adlar: *name takma adı için aynı belgede daha önce tanımlanmış bir &name çapası gerekir.
  • Uyarılar: Ayrıştırılabilen ancak amaçlandığı gibi çalışmayabilecek durumlar; örneğin ayrıştırıcının tanımadığı bir etiket veya desteklenmeyen bir %YAML sürümü.

Farklı eşlemelerde aynı anahtarın kullanılması sorun değildir; --- ile ayrılmış birden fazla belge içeren dosyalar da geçerlidir: satırlar dosyanın tamamı boyunca sayılır.

Neleri kontrol etmez?

Doğrulayıcı, metnin geçerli YAML olup olmadığını kontrol eder; belirli bir programın metni kabul edip etmeyeceğini değil. Bir Docker Compose dosyası geçerli YAML olabilir ancak yine de Docker Compose'un tanımadığı bir ayar içerebilir. Mesajlar yaml kütüphanesinden gelir ve İngilizcedir.

Nasıl çalışır?

Araç, YAML 1.2 belirtimini izleyen ve anahtarların benzersiz olmasını gerektiren yaml kütüphanesiyle metni ayrıştırır. Her şey tarayıcınızda çalışır: dosyalarınız hiçbir zaman yüklenmez.

Özellikler

  • Satır ve sütun bilgisiyle sözdizimi hataları
  • Yinelenen anahtarlar, girinti için kullanılan sekmeler ve çapa olmadan kullanılan takma adlar
  • Düzenleyicide işaretlenen hatalar ve uyarılar; ilgili konuma kaydırmak için tıklama
  • Birden fazla belge içeren dosyalar
  • Tarayıcınızda çalışır