Preskočiť na obsah

Formátor YAML

Overovanie a preformácia YAML s jasnou indikáciou chýb riadku a stĺpca.

Vstup
Výstup

Formátor YAML

YAML sa vyskytuje všade — od Kubernetesových manifestov cez GitHub Actions až po konfiguračné súbory aplikácií — a je nemilosrdný na biele znaky: jediná chybne zarovnaná medzera zničí celý dokument. Tento nástroj skontroluje syntax YAML dokumentu a prepíše ho konzistentne, aby ste mohli podchytiť rozbitý pipeline alebo konfiguračný súbor skôr, ako sa vôbec spustí.

Vložte dokument a je okamžite analyzovaný. Platný vstup sa vráti zreformátovaný s vaňou zvolenou šírkou odsadenia; neplatný vstup vráti presný riadok a stĺpec problému spolu s tým, čo analyzátor tam očakával, takže nebudete hádať, ktorý zo štyridsiatich riadkov má zablúdiaci tab. Dva testy prebehávajú automaticky na každom platnom dokumente: varovanie, ak niektorý riadok používa tab na odsadenie, keďže špecifikácia YAML zakazuje taby aj keď mnohé editory ich vkladajú ako predvolené, a počet duplikátnych kľúčov v rámci rovnakého mapingu, čo YAML povoľuje, ale zvyčajne znamená, že vyhráva posledný a ostatné boli zbytočné.

Možnosti kontrolujú tvar aj biele znaky. Zoraďte kľúče abecedne a dostanete deterministický, porovnateľný dokument — užitočné, keď generovaná konfigurácia nepretržite produkuje hlučné git diffy bez funkčného dôvodu. Zbaliť krátke zoznamy zmení skalárnu sekvenciu ako trojriadkový zoznam tagov na jeden riadok vo flow štýle napríklad tags: [a, b, c]; nechajte to vypnuté a ľubovoľné inline flow zoznamy budú rozšírené späť na jeden prvok na riadok, čo je zvyčajne ľahšie na revíziu a zlúčenie. Odstrániť komentáre vymaže plnoriadkové a koncové hash-komentáre pre verziu určenú na minifikáciu alebo zdieľanie bez poznámok, zatiaľ čo ich nechať vypnuté zachová váš dokument komentáre presne tak, ako sú napísané.

Formátovanie prebieha úplne vo vašom prehliadači. YAML, ktorý vložíte, nie je nikdy nahraný, zaznamenaný alebo odoslaný nikam — je analyzovaný, zreformátovaný a zobrazený lokálne a zmizne v momente, keď zatvoríte alebo znovu načítate stránku.

Časté otázky

Je môj YAML niekde nahraný?
Nie. Analýza a formátovanie prebieha úplne v JavaScriptovom moduli vášho prehliadača. Nič, čo vložíte, nie je posielané na server, zaznamenávané alebo ukladané mimo vášho zariadenia.
Čo znamená riadok a stĺpec v chybe?
Poukazujú na presné miesto vo vašom dokumente, kde analyzátor prestala rozumieť, počítajúc od vrchu a ľava textu, ktorý ste vložili. Uvádza tiež, čo tam očakával, napríklad konzistentné odsadenie alebo hodnotu za dvoma bodkami.
Prečo varovuje pred tabmi?
Špecifikácia YAML zakazuje používať znaky tabulátorov na odsadenie — povolené sú iba medzery. Dokument s odsadením tabmi môže v inej implementácii YAML nekonzistentne spracovať alebo úplne zlyhať, preto nástroj na to upozorní aj keď tu váš vstup ešte spracuje.
Čo sa stane s duplikátnymi kľúčmi?
YAML umožňuje opakovať kľúč v rámci rovnakého mapingu a väčšina analyzátorov ticho ponecháva iba poslednú hodnotu. Nástroj to neuráža, ale spočíta duplikáty a označí ovplyvnený riadok, aby ste sa mohli rozhodnúť, či to bolo úmyselné.
Môže mi to opraviť neplatný YAML?
Nie — presne vám oznámi, kde analýza zlyhala, aby ste mohli opraviť zdroj. Automatické hádanie opravy rozbitého odsadenia by riskovalo zmenu významu dokumentu.