TOML Validator & Linter
Проверить синтаксис TOML-файла на ошибки.
Как это работает
TOML выглядит простым форматом, но и в нем можно накосячить: забыть закрывающую кавычку, случайно определить один и тот же ключ дважды в одной таблице, или перепутать формат даты. Toml validator online проверяет синтаксис файла и сразу показывает разобранную структуру в виде JSON, если все в порядке, либо точное сообщение об ошибке, если что то сломано.
Валидация происходит через полноценный парсер TOML, а не через приблизительные регулярные выражения, поэтому проверяются реальные правила формата: уникальность ключей внутри таблицы, корректность синтаксиса массивов и вложенных таблиц, правильность формата чисел, дат и многострочных строк.
Удобно использовать перед коммитом изменений в pyproject.toml, Cargo.toml или конфиг любого другого инструмента, который использует TOML, чтобы не узнавать о синтаксической ошибке только в момент падения CI на совершенно непонятной стадии сборки проекта.
Частые вопросы
Какая самая частая ошибка при написании TOML файлов?
Дублирующийся ключ внутри одной таблицы, TOML в отличие от некоторых других форматов не позволяет молча взять последнее значение, а сразу считает это ошибкой синтаксиса и валидатор ее честно покажет.
Проверяет ли валидатор бизнес логику файла, например обязательные поля?
Нет, валидатор проверяет только синтаксическую корректность самого формата TOML, смысловые требования конкретного инструмента, который потом читает этот TOML, например обязательность поля name в Cargo.toml, валидатор не знает и не проверяет.
Что делать, если валидатор ругается на дату в непонятном формате?
TOML поддерживает несколько форматов дат по стандарту RFC 3339, самый безопасный вариант это полный формат год-месяц-день с большой буквой T и временем, если используется упрощенная запись, стоит свериться со спецификацией TOML.
Можно ли скопировать разобранную JSON структуру из результата валидации?
Да, поле результата это обычный текст, который можно выделить и скопировать целиком, показывает он итоговую структуру данных ровно так, как ее увидит любая программа после парсинга этого TOML файла.