Блог

Преобразование YAML в JSON: проверка раскрытых общих настроек

Преобразуйте YAML с общими значениями тайм-аута и повторных попыток в JSON, проверьте унаследованные и переопределённые значения, затем измените JSON и вернитесь к YAML. Разбираем также комментарии и якоря.

Английский интерфейс конвертера YAML ⇄ JSON: слева YAML со ссылками на общие настройки, справа JSON с раскрытыми значениями

Зададим общий тайм-аут 30 секунд и две повторные попытки, а для среды предварительного просмотра — ноль попыток. YAML позволяет ссылаться на общие настройки, но с ростом конфигурации всё сложнее проследить происхождение значений. Конвертер YAML ⇄ JSON позволяет преобразовать её в JSON и проверить результат раскрытия ссылок.

Раскрываем общие настройки YAML в JSON

Вставьте следующий пример в поле «YAML» слева. Для загрузки файла используйте соответствующую кнопку — «Load YAML file» в английском интерфейсе. &defaults задаёт имя общим настройкам, а <<: *defaults объединяет их с настройками preview.

# Shared request settings
defaults: &defaults
  timeoutSeconds: 30
  retries: 2
preview:
  <<: *defaults
  retries: 0

Нажмите «YAML → JSON». Результат появится в поле «JSON» справа. preview.timeoutSeconds наследует значение 30, а для preview.retries приоритет имеет явное переопределение, поэтому значение равно 0. defaults.retries остаётся равным 2.

Слева preview в YAML ссылается на общие настройки; справа в раскрытом JSON у preview указаны timeoutSeconds 30 и retries 0
Пример в английском интерфейсе. Справа видны окончательные значения preview.

Редактируем JSON и возвращаемся к YAML

  1. В поле JSON справа замените "timeoutSeconds": 30 внутри preview на "timeoutSeconds": 10. В defaults оставьте значение 30.
  2. Нажмите правую кнопку проверки — «Validate: JSON → YAML → JSON» в английском интерфейсе. Слева появится новый YAML, а под полями — результат проверки. Убедитесь, что preview.timeoutSeconds слева равен 10.
  3. Чтобы сохранить результат в файл, скопируйте содержимое нужного поля в текстовый редактор и сохраните его.
JSON с тайм-аутом preview, изменённым на 10 секунд, преобразованный YAML и сообщение об успешной проверке
Проверка, начинающаяся с JSON, заново читает полученный YAML и сравнивает структуры и значения данных, игнорируя порядок ключей.

Если нужно сохранить комментарии или типы

JSON не содержит комментариев и имён якорей исходного YAML. В этом инструменте на той же странице нажатие «JSON → YAML» иногда восстанавливает сохранённый оригинал, если данные JSON эквивалентны исходному YAML. Если изменить значение, как в примере, новый YAML создаётся из раскрытых данных. Чтобы изменить только тайм-аут, сохранив комментарии и ссылки на общие настройки, добавьте timeoutSeconds: 10 в preview исходного YAML.

Проверка, начинающаяся с YAML («Validate: YAML → JSON → YAML»), выводит JSON и сохраняет исходный текст YAML. Например, даже если для limit: .nan проверка сообщает об успехе, в JSON получится "limit": null. При переносе настроек, для которых важны типы, также проверяйте преобразованные значения непосредственно.