Loading…

Про програму Онлайн форматувальник TOML

Безладні `pyproject.toml`, `Cargo.toml` або `poetry` конфігурації? Вставте ваш TOML або перетягніть файл, і наш форматувальник нормалізує пробіли, прибереже масиви та вбудовані таблиці, і підтримуватиме послідовність відступів у ваших розділах. Ідеально для Python, Rust, Go, генераторів статичних сайтів та будь-яких проектів, що використовують TOML для конфігурації.

Ключові можливості форматувальника TOML

  • **Одноклікове прикрашання** для файлів конфігурації TOML та фрагментів
  • **Налаштовуваний розмір відступу** від 1 до 8 пробілів за допомогою повзунка *Розмір відступу*
  • **Перемикач стилю відступу** – виберіть між пробілами або табуляціями для відступів
  • **Контроль переносу / довжини рядка** для утримання довгих масивів та вбудованих таблиць у межах обраної ширини стовпця
  • Підтримує файли `.toml`, такі як `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` та інші
  • Парсер TOML на основі Prettier, який розуміє дати, масиви, вкладені таблиці та вбудовані таблиці
  • Стабільне, ідемпотентне форматування – повторний запуск для того самого файлу не викличе дрейфу форматування
  • Одноклікове копіювання відформатованого виводу, готового для вашого редактора або коміту

🛠️ Як форматувати файли TOML онлайн for toml-formatter

1

1. Вставте або завантажте ваш TOML

📥 Вставте TOML у редактор або перетягніть файл `.toml`, такий як `pyproject.toml` або `Cargo.toml`. Інструмент аналізує вміст як TOML, а не загальний INI/JSON.

2

2. Оберіть налаштування відступів та переносу

⚙️ Використовуйте повзунок **Розмір відступу**, щоб вибрати кількість пробілів на рівень відступу, та перемкніть **Стиль відступу** на табуляції, якщо ваш проєкт їх віддає перевагу. Налаштуйте **Перенесення / Довжина рядка**, щоб контролювати, коли довгі масиви або вбудовані таблиці мають переноситися (або встановіть значення `0`, щоб фактично вимкнути перенесення).

3

3. Натисніть «Форматувати»

🚀 Натисніть кнопку **Форматувати**. Форматувальник переформатує масиви, очистить пробіли навколо `=` і ком, нормалізує пробіли в таблицях та забезпечить послідовні розриви рядків, зберігаючи ваші дані.

4

4. Перегляньте, скопіюйте або збережіть

🔍 Порівняйте оригінальний та відформатований TOML. Коли ви задоволені, скопіюйте результат назад у ваш редактор або збережіть його як новий файл `.toml` у вашому проєкті.

Технічні характеристики

Підтримувані можливості TOML

Форматувальник створений для конфігурацій реальних проєктів і розуміє сучасні конструкції TOML.

МожливістьПідтримкаПриклади / Примітки
Таблиці та підтаблиці✅ Повна[tool.poetry], [project], [database.replica]
Масиви✅ ПовнаВбудовані масиви та масиви таблиць
Вбудовані таблиці✅ Повністюсервери = { альфа = "10.0.0.1", бета = "10.0.0.2" }
Дати та час✅ Повністю2025-09-23T10:20:30Z та локальні формати дат
Коментарі✅ Збережено# коментарі залишаються біля налаштувань, які вони описують
Багаторядкові рядки✅ ПовністюПотрійні лапки TOML для довгих текстових блоків

Опції форматування (відображені на елементи керування)

Ці опції безпосередньо доступні в інтерфейсі та пов'язані з базовим плагіном Prettier TOML:

ОпціяЕлемент керуванняДіапазон / ЗначенняЗа замовчуванням
Розмір відступуПовзунок розміру відступу1–8 пробілів2 пробіли
Стиль відступуВибір стилю відступуПробіли / ТабуляціїПробіли
Довжина рядкаПеренесення / Довжина рядка0–120 символів (0 = практично без перенесення)80 символів
Кінець рядкаКінець рядка (внутрішньо)LF / CRLFLF у виводі браузера

Вхідні дані та обмеження

Інструмент оптимізований для малих та середніх файлів TOML, які часто зустрічаються в репозиторіях додатків.

ПараметрЗначення / ПоведінкаПримітки
Розширення файлів.tomlБудь-який конфігураційний файл на основі TOML
Типи MIMEapplication/toml, text/x-tomlВикористовується для визначення файлів у зоні перетягування
Максимальний розмір файлу~5 МББільші файли можуть оброблятися повільніше, тому краще їх обробляти в CI
Максимальна кількість символів≈ 2 000 000Жорстке обмеження в середовищі виконання форматера для запобігання блокуванню браузера

Валідація та обробка помилок

Якщо ваш файл не є валідним TOML (наприклад, відсутній `=` або невідповідні лапки), форматер зазвичай поверне зрозумілу помилку замість відформатованого виводу. Виправте вказаний рядок і запустіть форматер знову.

Альтернативи командного рядка для форматування TOML

Подобається результат і хочете мати такий самий стиль у CI або pre-commit хуках? Ось варіанти для командного рядка:

Крос-платформний (Node.js / Prettier)

Встановіть Prettier та плагін TOML

npm install --save-dev prettier prettier-plugin-toml

Додає Prettier та парсер TOML до вашого проекту.

Відформатуйте файл TOML за допомогою Prettier

npx prettier --parser toml --write pyproject.toml

Перезаписує `pyproject.toml` на місці, використовуючи правила TOML Prettier.

Linux / macOS / Windows (Taplo CLI)

Форматування TOML за допомогою Taplo

taplo fmt pyproject.toml

Ще один популярний CLI-форматер для файлів TOML.

Перевірка форматування в CI

taplo fmt --check .

Завершує збірку з помилкою, якщо файли TOML не відформатовані належним чином.

Використовуйте цей онлайн-інструмент для швидких редагувань та експериментів, а потім застосовуйте той самий стиль за допомогою Prettier або Taplo у ваших CI-пайплайнах.

Поширені випадки використання форматера TOML

Пакування Python (`pyproject.toml`)

Тримайте метадані Python-проектів та конфігурацію інструментів чистими та легкими для перегляду.

  • Вирівнювання секцій `[project]`, `[tool.poetry]` та `[tool.black]`.
  • Нормалізація масивів залежностей та специфікаторів версій.
  • Зробіть різницю в конфігурації більш читабельною в pull-запитах.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Проекти Rust (`Cargo.toml`)

Приведіть до ладу маніфести пакетів Rust у воркспейсах та мікросервісах.

  • Тримайте `[dependencies]` та `[dev-dependencies]` відсортованими та з однаковими відступами.
  • Нормалізуйте вбудовані таблиці, що використовуються для складних прапорців функцій.
  • Стандартизуйте форматування в межах робочого простору з кількома крейтами.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

Статичні сайти та інструменти (Hugo, Zola тощо)

Очищайте TOML, що використовується для генераторів статичних сайтів та різноманітних інструментів.

  • Форматуйте `config.toml` для Hugo чи інших генераторів статичних сайтів.
  • Зберігайте багатомовні блоки конфігурації зручними для читання.
  • Нормалізуйте довгі списки, такі як пункти меню та таксономії.

❓ Frequently Asked Questions

❓Що таке форматувальник TOML?

Форматувальник TOML автоматично переструктурує ваші TOML-файли, щоб вони відповідали послідовному стилю: виправляє відступи, вирівнює масиви та вбудовані таблиці, нормалізує пробіли навколо `=` і ком, зберігаючи дані та роблячи їх зручнішими для читання та перегляду.

📏Як обрати розмір та стиль відступів?

Якщо ваша команда не має переваг, **2 пробіли** — хороший варіант за замовчуванням. Дотримуйтесь стилю, вже використовуваного у вашому репозиторії: якщо файли переважно мають відступи пробілами, продовжуйте їх використовувати; якщо табуляція є стандартом команди, змініть **Стиль відступу** на Табуляцію, щоб нові зміни відповідали існуючому коду.

🧪Чи перевіряє форматувальник синтаксис TOML?

Базовий парсер відхилить некоректний TOML (наприклад, відсутність `=` або невідповідні лапки). У такому разі інструмент покаже повідомлення про помилку замість відформатованого виводу, щоб ви могли виправити проблему та спробувати знову.

🔁Чи може форматування змінити поведінку моєї конфігурації?

Форматувальник розроблений для **збереження семантики**: він змінює лише пробіли та розташування, а не ключі, значення чи структуру таблиць. Доки початковий файл є коректним TOML, значення вашої конфігурації залишиться незмінним.

🔒Чи безпечно форматувати конфіденційні файли конфігурації?

Як і з будь-яким онлайн-інструментом, уникайте вставки надзвичайно конфіденційних матеріалів, таких як секрети продакшену. Для високо конфіденційних конфігурацій використовуйте локальний форматувальник TOML (як Prettier чи Taplo) у вашому закритому середовищі розробки.

Pro Tips

Best Practice

Зберігайте добре відформатовані `pyproject.toml` або `Cargo.toml` у головній гілці, а потім застосовуйте той самий стиль у CI за допомогою Prettier чи Taplo.

Best Practice

Форматуйте TOML перед комітом великих змін залежностей чи конфігурації, щоб ваші Git-різниці фокусувалися на **справжніх змінах**, а не на шумі від пробілів.

Best Practice

Під час рефакторингу конфігурацій спочатку відформатуйте файл, зробіть коміт, а потім змініть значення. Це полегшить перевірку того, що справді змінилося.

Best Practice

Використовуйте однаковий **розмір відступу** та **довжину переносу** у всіх ваших TOML-файлах, щоб навігація між проектами та перегляд коду були послідовними.

Additional Resources

Специфікація TOML v1.0.0
Documentation
Плагін Prettier для TOML
Documentation
Taplo – Набір інструментів TOML
Documentation

Other Tools