От YAML к JSON

Пример конвертации

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults
  host: prod.example.com
  debug: false

staging:
  <<: *defaults
  host: staging.example.com
  debug: true

JSON (анкеры разрешены):

{
  "defaults": {
    "timeout": 30,
    "retries": 3
  },
  "production": {
    "timeout": 30,
    "retries": 3,
    "host": "prod.example.com",
    "debug": false
  },
  "staging": {
    "timeout": 30,
    "retries": 3,
    "host": "staging.example.com",
    "debug": true
  }
}

Маппинг типов

Аспекты, специфичные для YAML, которые невозможно представить в JSON

• Комментарии. В JSON нет стандартного синтаксиса комментариев; они отбрасываются.
• Потоки из нескольких документов (разделители ---). В формате JSON в каждом файле содержится один документ; при наличии нескольких документов конвертер выдаёт массив документов.
• Анкеры и псевдонимы. Разрешаются и дублируются внутри строки.
• Сложные ключи (ключи сопоставления, не являющиеся строками). Ключи в формате JSON должны быть строками; сложные ключи преобразуются в строки.

Примечание о различиях между версиями 1.1 и 1.2

• YAML 1.1 интерпретирует значения yes, no, on, off, y и n как логические; значение NO, представляющее собой код страны, незаметно преобразуется в false.
• YAML 1.2 ограничивает значения типа boolean только значениями true и false; этот вариант более безопасен, однако многие парсеры (включая стандартный пакет PyYAML) по-прежнему используют версию 1.1.

Конвертер по умолчанию использует семантику версии 1.2 и выдаёт предупреждение, если бы применение версии 1.1 привело к изменению результата.

Обратное преобразование из JSON в YAML

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