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