Преобразуйте YAML в JSON!

Введите YAML, чтобы преобразовать его в JSON! Поддержка: yml, Kubernetes, docker-compose.
YAML
Результат
 

Преобразуйте YAML в JSON!

Преобразует документ YAML (yml) в JSON, чтобы увидеть структуру, которую скрывают отступы, и фактический тип, в который разобрано каждое значение. Якоря и алиасы разворачиваются в реальные значения, а несколько документов, разделённых ---, собираются в массив.

Особенно удобно для поимки классических ошибок YAML: значение, прицепившееся не к тому родителю из-за одного пропущенного пробела, или version: 1.10, молча ставший числом 1.1.

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

  1. Вставьте docker-compose.yml, манифест Kubernetes или файл workflow в поле YAML или перетащите файл на него.
  2. Синтаксические ошибки выводятся в результат с номерами строки и столбца; первым делом проверьте отступы в этом месте.
  3. Прочитайте JSON в Результат, чтобы увидеть, стало ли каждое значение строкой, числом или булевым, и при необходимости скопируйте его.

Пример

Вход (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
Результат (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

Ключ on: из GitHub Actions остаётся строковым ключом "on", потому что этот инструмент разбирает по правилам YAML 1.2. Блок, определённый с якорем &node, развёрнут на месте *node.

Возможности

  • Разбор по core-схеме YAML 1.2: yes, on и off остаются строками, булевыми становятся только true/True/false.
  • ~ и пустые значения становятся null; шестнадцатеричное 0x1F и восьмеричное 0o17 — числами.
  • Якоря (&anchors) и алиасы (*aliases) разрешаются в значения, на которые ссылаются.
  • Литеральные | и свёрнутые > блочные скаляры превращаются в строки с применением правил YAML для переводов строк.
  • Несколько документов, разделённых ---, становятся JSON-массивом; один документ выводится как самостоятельное значение.
  • Ключ, встречающийся дважды в одном отображении, считается ошибкой.

Сценарии использования

Проверка отступов в манифесте Kubernetes

Если env под containers сдвинут на уровень меньше, он молча прицепляется к другому полю, и вы узнаёте об этом только при apply. В JSON фигурные скобки точно показывают, какому объекту он принадлежит.

Использование конфига из кода

Для скрипта или фронтенд-бандла, куда тащить YAML-парсер избыточно, преобразуйте конфиг один раз и используйте как import config from './config.json'.

Изучение спецификации OpenAPI

Документ OpenAPI, написанный на YAML, после преобразования проще опрашивать через JSONPath или jq — например, чтобы вытащить схему по конкретному пути.

Примечания и ограничения

  • Ключи слияния (<<: *defaults) применяются: ключи отображения с якорем копируются, а ключи, записанные рядом с <<, их переопределяют. Парсер, поддерживающий только YAML 1.2, оставил бы << обычным ключом, так что результаты таких инструментов могут отличаться.
  • Даты и время вроде 2024-01-01 остаются строками, а не становятся значениями Date.
  • У .inf и .nan нет представления в JSON, и они становятся null.
  • Комментарии перенести в JSON нельзя, и они отбрасываются.
  • PyYAML (YAML 1.1) читает on и yes как true, так что результаты из Python могут отличаться.

Частые вопросы

Почему on из GitHub Actions показан как "on", а не true?

В YAML 1.2 булевы значения — только true и false, так что on — обычная строка; так же этот ключ читает и GitHub Actions. PyYAML в Python следует 1.1 и превращает его в ключ True, так что будьте внимательны, разбирая workflow из скриптов.

version: 1.10 выводится как 1.1.

1.10 без кавычек в YAML — число, а 1.10 равно 1.1. Чтобы сохранить строку версии, возьмите её в кавычки в исходном YAML: "1.10".

Что происходит с файлом, где несколько документов?

Каждый документ, отделённый ---, по порядку становится элементом массива, так что файл с несколькими ресурсами для kubectl apply -f даёт массив ресурсов.