YAML в TOML

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

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

Какие данные можно перенести в TOML

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

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

Как связаны YAML-объекты и разделы TOML

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

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

Когда список должен стать массивом таблиц

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

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

Как преобразовать настройки

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

Если преобразование останавливается на null, сначала решите, как принимающая программа обозначает отсутствие настройки. Удаление поля, пустая строка и пустой список имеют разные значения и не являются универсальной заменой.

Проверка перед заменой конфигурационного файла

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

Повторные ключи, неизвестные YAML-теги, циклы, чрезмерная вложенность и числа вне поддерживаемой точности отклоняются. Для промежуточной проверки структуры можно сначала получить JSON из YAML.