YAML validators

Tas parsē pilnu YAML sintaksi: atkāpes, bloka un plūsmas kolekcijas, pēdiņās ietvertus un parastus skalārus, enkurus, aizstājvārdus, tagus un direktīvas. Tas arī uzskata dublētas atslēgas kartējumā par kļūdu. Rezultātā tiek parādīts vai nu apstiprinājums ar īsu kopsavilkumu, vai arī pirmā kļūda, tās atrašanās vieta un paskaidrojums.

Validētājs izmanto YAML 1.2 pamatspecifikāciju — pašreizējo specifikācijas versiju. Saskaņā ar 1.2 tādi vārdi kā yes, no, on un off ir parastas virknes, nevis Būla vērtības, tāpēc tie nekad neizraisa kļūdu. Dokumenti, kas rakstīti rīkiem, kuri izmanto YAML 1.1, joprojām tiek pieņemti, ja to sintakse ir derīga.

YAML specifikācija pieprasa, lai atslēgas kartējumā būtu unikālas. Daudzi parsētāji klusi patur pēdējo vērtību, tādējādi paslēpjot konfigurācijas kļūdas, piemēram, divreiz definētu iestatījumu. Validētājs norāda atkārtotās atslēgas rindu un kolonnu, lai varētu izlemt, kuru vērtību paturēt.

Rindu un kolonnu skaitīšana sākas ar 1 no ielīmētās ievades sākuma. Dokumentus skaita to parādīšanās secībā; tos atdala --- rindas, tāpēc pirmais dokuments ir dokuments 1. Norādītā pozīcija ir vieta, kur parsētājs konstatēja problēmu, un tā var būt tieši pēc pašas kļūdas.

Jā. Atdaliet dokumentus ar ---, kā tas tiek darīts vairāku dokumentu Kubernetes manifestā, un tiks parsēts katrs dokuments. Ja rezultāts ir derīgs, tiek parādīts dokumentu skaits un katra dokumenta augstākā līmeņa tips.

Tas norāda, kas atrodas katra dokumenta saknes līmenī: atslēgu un vērtību kartējums, vienumu secība, viena skalāra vērtība vai nekas. Vairums konfigurācijas failu ir kartējumi, savukārt resursu saraksti bieži ir secības. Nepareizs tips parasti nozīmē, ka defise vai atkāpe ir novietota nepareizi.

Brīdinājumi ir problēmas, kas neaptur parsēšanu, piemēram, parsētājam nezināma birka, kas pēc tam tiek nolasīta kā parasta vērtība. Katrs brīdinājums ir norādīts kopā ar tā rindu un kolonnu; tiek parādīti ne vairāk kā 20 brīdinājumi. Dokuments ar brīdinājumiem joprojām tiek uzskatīts par derīgu.

YAML aizliedz izmantot tabulatorus atkāpēm, jo to platums nav viennozīmīgs. Aizstājiet tabulatorus norādītās rindas sākumā ar atstarpēm un saglabājiet atkāpes konsekventas ar apkārtējām rindām. Tabulatori vērtībās un pēdiņās ievietotās virknēs ir atļauti.

Jā. Aliasi var izvērst ne vairāk kā 100 reizes, tāpēc dokuments, kas izveidots, lai aliasus pavairotu līdz gigabaitiem datu — šādu uzbrukumu bieži dēvē par billion laughs uzbrukumu — tiek atzīmēts kā nederīgs, nevis iztērēta visa atmiņa. Parasta enkuru un aliasu izmantošana kopīgiem iestatījumiem paliek krietni zem šī ierobežojuma.

Nē, tas pārbauda tikai sintaksi un struktūru, nevis to, vai atslēgas un vērtības atbilst konkrētai shēmai. Ievades apjoms var sasniegt 5 MiB. Lai derīgu YAML pārveidotu par JSON, TOML vai citu formātu, izmantojiet datu formāta pārveidotāju.