Преобразует документ YAML (yml) в JSON, чтобы увидеть структуру, которую скрывают отступы, и фактический тип, в который разобрано каждое значение. Якоря и алиасы разворачиваются в реальные значения, а несколько документов, разделённых ---, собираются в массив.
Особенно удобно для поимки классических ошибок YAML: значение, прицепившееся не к тому родителю из-за одного пропущенного пробела, или version: 1.10, молча ставший числом 1.1.
YAML или перетащите файл на него.Результат, чтобы увидеть, стало ли каждое значение строкой, числом или булевым, и при необходимости скопируйте его.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"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.
yes, on и off остаются строками, булевыми становятся только true/True/false.~ и пустые значения становятся null; шестнадцатеричное 0x1F и восьмеричное 0o17 — числами.&anchors) и алиасы (*aliases) разрешаются в значения, на которые ссылаются.| и свёрнутые > блочные скаляры превращаются в строки с применением правил YAML для переводов строк.---, становятся JSON-массивом; один документ выводится как самостоятельное значение.Если env под containers сдвинут на уровень меньше, он молча прицепляется к другому полю, и вы узнаёте об этом только при apply. В JSON фигурные скобки точно показывают, какому объекту он принадлежит.
Для скрипта или фронтенд-бандла, куда тащить YAML-парсер избыточно, преобразуйте конфиг один раз и используйте как import config from './config.json'.
Документ OpenAPI, написанный на YAML, после преобразования проще опрашивать через JSONPath или jq — например, чтобы вытащить схему по конкретному пути.
<<: *defaults) применяются: ключи отображения с якорем копируются, а ключи, записанные рядом с <<, их переопределяют. Парсер, поддерживающий только YAML 1.2, оставил бы << обычным ключом, так что результаты таких инструментов могут отличаться.2024-01-01 остаются строками, а не становятся значениями Date..inf и .nan нет представления в JSON, и они становятся null.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 даёт массив ресурсов.