Форматиране на TOML
Форматирайте TOML конфигурационни файлове, като Cargo.toml, pyproject.toml и други настройки на приложения, с TOML приставката Prettier. Форматиращият инструмент уеднаквява интервалите около знаците за равенство, вградените таблици и масивите, разделя таблиците с празен ред, запазва всички коментари и съобщава синтактичните грешки с ред и колона, така че разработчиците да могат безопасно да подредят конфигурацията преди commit.
Често задавани въпроси
Кой механизъм форматира TOML?
Инструментът използва Prettier 3 с prettier-plugin-toml 4.1 на сървъра. Той чете документи TOML 1.0 и ги извежда в единен стил.
Какво се променя в резултата?
Между ключовете и стойностите и знака за равенство се поставя по един интервал, а вградените таблици и масивите се форматират равномерно. Допълнителните празни редове се премахват, а всеки раздел с таблица се отделя от предходния с празен ред.
Запазват ли се коментарите?
Да. Коментарите на отделен ред и коментарите след стойности остават на мястото си, така че поясненията в конфигурационните файлове се запазват.
Ще бъдат ли сортирани ключовете или таблиците?
Не. Ключовете, таблиците и масивите от таблици запазват първоначалния си ред, което е важно за файловете, които хората четат от начало до край.
Могат ли кавичките около низовете да се променят?
Низовете с единични кавички може да бъдат пренаписани с двойни, ако стойността не съдържа обратна наклонена черта или двойна кавичка, без да се променя самата стойност. Низовете, които изискват буквално цитиране, запазват единичните си кавички.
Как се обработват дългите масиви?
Масивите, които се побират в ширината за печат, остават на един ред. Масивите със завършваща запетая или надхвърлящи ширината се отпечатват с по един елемент на ред.
Какво се случва при невалиден TOML?
Форматирането спира и инструментът показва съобщението на анализатора с реда и колоната, например когато липсва стойност след знак за равенство. Дублираните ключове и другият невалиден TOML се съобщават по същия начин.
Мога ли да променя отстъпа?
Да. Изберете отстъп от 2 или 4 интервала или табулации за вложени масиви и ширина на реда за печат от 40 до 200 знака; по подразбиране е 80.
Колко голям може да бъде файлът?
До 1 MB текст на заявка — много повече от обичайния размер на конфигурационните файлове. Форматирането спира след 10 секунди.
Съхранява ли се конфигурацията ми?
Не. Конфигурационните файлове може да съдържат тайни, затова съдържанието се обработва само в паметта и никога не се запазва или записва в логове.