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]
Массивы✅ ПолнаяВстроенные массивы и массивы таблиц
Встроенные таблицы✅ Полнаяservers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Даты и время✅ Полная2025-09-23T10:20:30Z и локальные форматы дат
Комментарии✅ Сохранены# комментарии остаются рядом с описываемыми настройками
Многострочные строки✅ ПолнаяТройные кавычки TOML для длинных текстовых блоков

Параметры форматирования (сопоставлены с элементами управления)

Эти параметры напрямую доступны в интерфейсе и связаны с базовым плагином Prettier TOML:

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

Ввод и ограничения

Инструмент оптимизирован для небольших и средних файлов TOML, обычно встречающихся в репозиториях приложений.

ПараметрЗначение / ПоведениеПримечания
Расширения файлов.tomlЛюбой конфигурационный файл на основе TOML
MIME-типыapplication/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

Еще один популярный форматировщик командной строки для TOML файлов.

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

taplo fmt --check .

Прерывает сборку, если TOML файлы не отформатированы должным образом.

Используйте этот онлайн-инструмент для быстрого редактирования и экспериментов, а затем применяйте тот же стиль с Prettier или Taplo в ваших CI пайплайнах.

Распространенные случаи использования TOML форматировщика

Python упаковка (`pyproject.toml`)

Поддерживайте метаданные Python проектов и конфигурацию инструментов чистыми и удобными для проверки.

  • Выравнивание секций `[project]`, `[tool.poetry]` и `[tool.black]`.
  • Нормализация массивов зависимостей и спецификаторов версий.
  • Упрощение чтения различий конфигурации в pull request'ах.
[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 (например, отсутствие `=` или несовпадающие кавычки). В этом случае инструмент показывает сообщение об ошибке вместо форматированного вывода, чтобы вы могли исправить проблему и повторить попытку.

🔁Может ли запуск форматтера изменить поведение моей конфигурации?

Форматтер разработан как **сохраняющий семантику**: он изменяет только пробелы и layout, но не ключи, значения или структуру таблиц. Пока исходный файл является валидным 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