TOML в YAML

Для чего нужен конвертер TOML в YAML

Конвертер TOML в YAML переводит таблицы и значения TOML в YAML-документ. Он помогает перенести поддерживаемую структуру настроек в систему, использующую YAML, с управлением отступами и порядком ключей.

Разные способы записи одних данных

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

Поэтому комментарии и исходное оформление TOML не переносятся. Даты и время приводятся к строкам после разбора: результат не сохраняет отдельный TOML-тип даты. Необычные числовые значения, включая бесконечность, не подходят для используемого преобразования.

Что означают таблицы и списки в итоговом YAML

Таблица TOML является набором именованных настроек. В YAML ей соответствует отображение, обычно записываемое строками ключ: значение. Массив сохраняет порядок значений, а массив таблиц становится списком объектов с собственными полями.

При ручном редактировании удобно сначала найти начало каждого элемента списка и только затем менять его поля. Если сдвинуть строку на уровень выше, значение может перейти в родительский объект вместо нужного элемента. Внешне это иногда выглядит как обычное изменение отступа, но данные уже будут другими.

Строки, похожие на типизированные значения

YAML умеет отличать строки от чисел, логических значений и null. Кавычки в результате помогают сохранить строкой значение, которое без них могло бы читаться иначе. Поэтому кавычки вокруг версии, кода или слова с особым смыслом не стоит удалять автоматически.

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

Как получить YAML и проверить отступы

Вставьте настройки в «Исходный текст», задайте «Пробелов в отступе» и при необходимости включите «Сортировать ключи». YAML появится автоматически. Скачивание создает файл .yaml.

После копирования не заменяйте отступы табуляцией: вложенность YAML зависит от пробелов. Если редактируете списки вручную, следите, чтобы новый элемент находился на том же уровне, что и соседние элементы списка.

Перенос конфигурации между приложениями

Результат полезен как основа для переноса конфигурации, но имена параметров не преобразуются в соглашения другого продукта. Если исходное приложение ожидает таблицу server, наличие такого же YAML-объекта еще не делает документ подходящим Kubernetes или CI.

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