Formátovač TOML
Formátujte konfiguračné súbory TOML, napríklad Cargo.toml, pyproject.toml a nastavenia ďalších aplikácií, pomocou pluginu Prettier TOML. Formátovač zjednotí medzery okolo znamienok rovnosti, v inline tabuľkách a poliach, oddelí tabuľky prázdnym riadkom, zachová všetky komentáre a oznámi syntaktické chyby spolu s číslom riadka a stĺpca, aby vývojári mohli bezpečne upratať konfiguráciu pred jej potvrdením.
Často kladené otázky
Ktorý nástroj formátuje TOML?
Nástroj na serveri používa Prettier 3 s prettier-plugin-toml 4.1. Číta dokumenty TOML 1.0 a vypisuje ich v jednotnom štýle.
Čo sa vo výstupe zmení?
Medzi kľúčmi a hodnotami bude jedna medzera okolo znamienka rovnosti a inline tabuľky a polia budú mať rovnomerné medzery. Nadbytočné prázdne riadky sa odstránia a každá hlavička tabuľky sa oddelí od predchádzajúcej sekcie prázdnym riadkom.
Zachovajú sa komentáre?
Áno. Komentáre na samostatnom riadku aj komentáre za hodnotami zostanú na svojom mieste, takže poznámky v anotovaných konfiguračných súboroch sa zachovajú.
Usporiadajú sa kľúče alebo tabuľky?
Nie. Kľúče, tabuľky a polia tabuliek zostanú v pôvodnom poradí, čo je dôležité pri čítaní súborov zhora nadol.
Môžu sa zmeniť úvodzovky reťazcov?
Doslovné reťazce v apostrofoch sa môžu prepísať s dvojitými úvodzovkami, ak hodnota neobsahuje spätnú lomku ani dvojitú úvodzovku, takže hodnota zostane rovnaká. Reťazce, ktoré vyžadujú doslovné úvodzovky, si zachovajú apostrofy.
Ako sa spracúvajú dlhé polia?
Polia, ktoré sa zmestia do šírky tlače, zostanú na jednom riadku. Polia s čiarkou na konci alebo tie, ktoré prekročia šírku, sa vypíšu po jednom prvku na riadok.
Čo sa stane pri neplatnom TOML?
Formátovanie sa zastaví a nástroj zobrazí hlásenie analyzátora s číslom riadka a stĺpca, napríklad informáciu o chýbajúcej hodnote za znamienkom rovnosti. Rovnako sa hlásia aj duplicitné kľúče a ďalšie neplatné TOML.
Môžem zmeniť odsadenie?
Áno. Pre vnorené polia vyberte 2 alebo 4 medzery či tabulátory a nastavte šírku tlače od 40 do 200 znakov; predvolená hodnota je 80.
Aký veľký môže byť súbor?
Až 1 MB textu na požiadavku, čo výrazne prevyšuje veľkosť bežných konfiguračných súborov. Formátovanie sa zastaví po 10 sekundách.
Ukladá sa moja konfigurácia?
Nie. Keďže konfiguračné súbory môžu obsahovať tajné údaje, ich obsah sa spracúva iba v pamäti a nikdy sa neukladá ani nezaznamenáva.