Реклама мешает? Идти Без рекламы Сегодня 

Форматировщик и валидатор TOML

ДанныеРазработчик

РЕКЛАМА · УДАЛЯТЬ?

ВХОД

Автоматический процесс

ВЫХОД

Клиентская сторона

Отформатированный TOML

РЕКЛАМА · УДАЛЯТЬ?

Гид

Форматировщик и валидатор TOML

TOML (Tom’s Obvious Minimal Language) стал предпочтительным форматом конфигурации для проектов Rust (Cargo.toml), упаковки Python (pyproject.toml) и множества других инструментов. Он разработан для удобства чтения человеком, но файлы конфигурации, редактируемые вручную, неизбежно теряют единообразие — несогласованные пробелы, перепутанный порядок ключей и тонкие синтаксические ошибки, которые проявляются только на этапе сборки.

Этот инструмент анализирует ваш TOML на стороне клиента, проверяет его соответствие спецификации и повторно выводит с чистым, согласованным форматированием. Он также преобразует TOML в JSON для быстрой проверки совместимости. Ничто не покидает ваш браузер.

Как использовать

Вставьте содержимое TOML в область ввода или попробуйте один из встроенных примеров (Cargo.toml, pyproject.toml). Выберите предпочтения по отступам, включите сортировку ключей по алфавиту, если это необходимо, и отформатированный вывод появится мгновенно. Используйте вкладку JSON, чтобы увидеть разобранную структуру в формате JSON. Скопируйте или загрузите результат одним щелчком мыши.

РЕКЛАМА · УДАЛЯТЬ?

Функции

Проверка синтаксиса – Обнаруживает ошибки с указанием номеров строк и описательными сообщениями до того, как они сломают вашу сборку
Единообразное форматирование – Нормализует отступы, пробелы вокруг знаков равенства и пустые строки между таблицами
Сортировка ключей – При желании алфавитизируйте ключи в каждой таблице для предсказуемого порядка
Настраиваемый отступ – Выберите 2 или 4 пробела, чтобы соответствовать соглашениям вашего проекта
Преобразование TOML в JSON – Просматривайте свою конфигурацию в формате JSON для быстрой отладки или интеграции с API
Встроенные примеры – Загружайте примеры конфигураций Cargo.toml или pyproject.toml для мгновенной проверки форматирования
Обработка на стороне клиента – Ваши файлы конфигурации остаются в вашем браузере — ничего не отправляется на сервер

Когда использовать этот инструмент

Прогоните свой TOML через форматировщик перед фиксацией изменений конфигурации, при слиянии конфигураций от нескольких участников или при миграции между версиями TOML. Преобразование в JSON особенно полезно, когда вам нужно передать конфигурации на основе TOML в инструменты или API, поддерживающие только JSON.

 Часто задаваемые вопросы

Что такое TOML и чем он отличается от YAML и JSON?

TOML (Tom's Obvious Minimal Language) — это формат файла конфигурации, разработанный для удобства чтения и записи. В отличие от YAML, TOML избегает значительных пробелов и сложного вложения, которые вызывают тонкие ошибки. В отличие от JSON, TOML поддерживает комментарии, имеет нативные типы даты/времени и более удобен для человека в файлах конфигурации. TOML уступает некоторую гибкость YAML в пользу предсказуемости — как правило, существует только один способ выразить что-либо в TOML.
Что такое таблица TOML и чем отличаются встраиваемые таблицы?

Таблица TOML — это коллекция пар ключ-значение под заголовком, таким как [package] или [dependencies]. Таблицы могут быть вложенными с использованием точечных заголовков, таких как [server.database]. Встраиваемые таблицы — это компактный однострочный синтаксис с использованием фигурных скобок: key = { name = 'value', version = '1.0' }. Обычные таблицы лучше подходят для удобочитаемости при большом количестве ключей, в то время как встраиваемые таблицы хорошо работают для небольших, тесно связанных групп значений.
Почему проекты Rust используют Cargo.toml вместо JSON или YAML?

Rust выбрал TOML для Cargo, потому что он обеспечивает баланс между читаемостью человеком и машинной обрабатываемостью. Явная типизация TOML (строки, целые числа, булевы значения, даты) уменьшает двусмысленность, которая преследует YAML (где 'no' может быть интерпретировано как булево значение). Поддержка комментариев имеет решающее значение для документирования выбора зависимостей. Простота формата также означает меньше крайних случаев при разборе и более предсказуемое поведение в различных инструментах и редакторах.
Что такое массивы таблиц в TOML?

Массивы таблиц используют двойные квадратные скобки [[table_name]] для определения нескольких экземпляров одного типа таблицы. Например, [[bin]] в Cargo.toml определяет несколько бинарных целей. Каждый блок [[bin]] добавляет новый элемент в массив. Это способ TOML представлять массивы объектов без визуального шума массивов JSON или списков YAML, основанных на дефисах.
Как pyproject.toml работает для упаковки Python?

pyproject.toml — это стандартизированный файл конфигурации проекта Python (определен в PEP 518 и PEP 621). Он заменяет старый подход setup.py и setup.cfg. Таблица [build-system] указывает требования к сборке, [project] содержит метаданные, такие как имя, версия и зависимости, а таблицы [tool.*] содержат конфигурацию для конкретных инструментов, таких как pytest, black или mypy. Это объединяет несколько файлов конфигурации в одно стандартное место.