Přeskočit na obsah

Formátor YAML

Ověření a přeformátování YAML s jasným označením chyb řádku a sloupce.

Vstup
Výstup

Formátor YAML

YAML se vyskytuje všude — od manifestů Kubernetes přes pracovní postupy GitHub Actions až po konfigurační soubory aplikací — a je neúprosný na prázdné znaky: jediný chybně zarovnaný prostor zničí celý dokument. Tento nástroj zkontroluje syntaxi YAML dokumentu a přepíše jej konzistentně, takže můžete zachytit rozbitý pipeline nebo konfigurační soubor dříve, než se vůbec spustí.

Vložte dokument a je okamžitě analyzován. Platný vstup se vrátí přeformátovaný s vámi zvolenou šířkou odsazení; neplatný vstup vrátí přesný řádek a sloupec problému spolu s tím, co parser tam očekával, takže nebudete hádat, který ze čtyřiceti řádků má bloudícího tabulátora. Dva testy se automaticky spouštějí na každém platném dokumentu: upozornění, pokud nějaký řádek používá tabulátor na odsazení, protože specifikace YAML zakazuje tabulátory i když mnoho editorů je standardně vkládá, a počet duplicitních klíčů v rámci stejného mapování, což YAML umožňuje, ale obvykle znamená, že zvítězí poslední a ostatní byly mrtvá váha.

Možnosti řídí tvar i prázdné znaky. Seřaďte klíče abecedně a získáte deterministický, porovnatelný dokument — užitečné, když generovaná konfigurace neustále produkuje hlučné git diffy bez funkčného důvodu. Sbalení krátkých seznamů změní skalární sekvenci jako třířádkový seznam štítků na jeden řádek ve stylu toku, jako je tags: [a, b, c]; ponechte jej vypnutý a jakékoli vložené seznamy toku ve vstupu budou rozšířeny zpět na jednu položku na řádek, což je obvykle snadnější na kontrolu a sloučení. Odebrat komentáře odstraní jak řádkové, tak koncové hash-komentáře pro verzi určenou k minifikaci nebo sdílení bez poznámek, zatímco jejich ponechání vypnuté zachová vaše komentáře dokumentu přesně tak, jak jsou napsány.

Formátování probíhá zcela ve vašem prohlížeči. YAML, který vložíte, není nikdy nahrán, zaznamenán ani odeslán nikam — je analyzován, přeformátován a zobrazen místně a zmizí v okamžiku, kdy zavřete nebo znovu načtete stránku.

Časté dotazy

Je můj YAML někde nahrán?
Ne. Analýza a formátování probíhají zcela v JavaScriptovém enginu vašeho prohlížeče. Nic, co vložíte, se neposílá na server, nezaznamenává se ani neukládá mimo vaše zařízení.
Co znamená řádek a sloupec v chybě?
Poukazují na přesné místo ve vašem dokumentu, kde parser přestal rozumět, počítáno od horní části a levé strany vloženého textu. Také uvádí, co tam očekával, například konzistentní odsazení nebo hodnotu za dvojtečkou.
Proč upozorňuje na tabulátory?
Specifikace YAML zakazuje používání znaků tabulátoru pro odsazení — povoleny jsou pouze mezery. Dokument s odsazením tabulátorem se může v jiné implementaci YAML analyzovat nekonzistentně nebo zcela selhat, proto nástroj na to upozorní, i když se váš vstup zde stále analyzuje.
Co se stane s duplicitními klíči?
YAML umožňuje opakování klíče v rámci stejného mapování a většina parserů tiše uchová pouze poslední hodnotu. Nástroj to neodsuzuje, ale počítá duplikáty a označí ovlivněný řádek, abyste se mohli rozhodnout, zda to bylo záměrné.
Může mi opravit neplatný YAML?
Ne — přesně vám oznámí, kde se analýza nezdařila, abyste mohli opravit zdroj. Automatické hádání opravy rozbitého odsazení by riskoval změnu významu dokumentu.