Formátovač TOML
Formátujte konfigurační soubory TOML, například Cargo.toml, pyproject.toml a další nastavení aplikací pomocí pluginu Prettier TOML. Formátovač sjednotí mezery kolem rovnítka, v inline tabulkách a polích, oddělí tabulky prázdným řádkem, zachová všechny komentáře a ohlásí chyby syntaxe včetně řádku a sloupce. Vývojáři tak mohou bezpečně upravit konfiguraci před jejím potvrzením.
Často kladené otázky
Který nástroj formátuje TOML?
Nástroj na serveru používá Prettier 3 s prettier-plugin-toml 4.1. Čte dokumenty TOML 1.0 a vypisuje je v jednotném stylu.
Co se ve výstupu změní?
Kolem rovnítka bude mezi klíči a hodnotami jedna mezera a inline tabulky a pole budou mít jednotné mezery. Nadbytečné prázdné řádky se sloučí a každá hlavička tabulky se od předchozí části oddělí prázdným řádkem.
Zachovávají se komentáře?
Ano. Jednořádkové komentáře i komentáře na konci řádku za hodnotami zůstanou na svém místě, takže anotované konfigurační soubory nepřijdou o poznámky.
Seřadí se klíče nebo tabulky?
Ne. Klíče, tabulky i pole tabulek zůstanou v původním pořadí, což je důležité u souborů, které lidé čtou od začátku do konce.
Mohou se změnit uvozovky řetězců?
Řetězce s jednoduchými uvozovkami mohou být přepsány na řetězce s dvojitými uvozovkami, pokud hodnota neobsahuje zpětné lomítko ani dvojitou uvozovku; hodnota tak zůstane stejná. Řetězce, které vyžadují doslovné uvozovky, si jednoduché uvozovky zachovají.
Jak se zpracovávají dlouhá pole?
Pole, která se vejdou do šířky tisku, zůstanou na jednom řádku. Pole s koncovou čárkou nebo přesahující šířku se vypíší po jednom prvku na řádek.
Co se stane při neplatném TOML?
Formátování se zastaví a nástroj zobrazí zprávu parseru s řádkem a sloupcem, například když za rovnítkem chybí hodnota. Stejně se hlásí i duplicitní klíče a další neplatné TOML.
Mohu změnit odsazení?
Pro vnořená pole zvolte 2 nebo 4 mezery, případně tabulátory, a nastavte šířku tisku od 40 do 200 znaků; výchozí hodnota je 80.
Jak velký může být soubor?
Až 1 MB textu na požadavek, což je mnohem víc než u běžných konfiguračních souborů. Formátování se ukončí po 10 sekundách.
Ukládá se moje konfigurace?
Ne. Konfigurační soubory mohou obsahovat tajné údaje, proto se jejich obsah zpracovává pouze v paměti a nikdy se neukládá ani nezaznamenává.