YAML para JSON

Exemplo de conversão

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (âncoras resolvidas):

{
  "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
  }
}

Mapeamentos de tipo

Coisas específicas de YAML que JSON não pode representar

• Comentários. JSON não tem uma sintaxe de comentário padrão. Comentários são descartados.
• Streams de múltiplos documentos (--- separadores). JSON é um documento por arquivo; o conversor emite um array de documentos quando há múltiplos.
• Âncoras e aliases. Resolvidos e duplicados inline.
• Chaves complexas (chaves de mapeamento não-string). Chaves JSON devem ser strings; chaves complexas são convertidas em strings.

O problema do 1.1 vs 1.2

• YAML 1.1 analisa yes, no, on, off, y, n como booleanos. NO como código de país se torna silenciosamente false.
• YAML 1.2 restringe booleanos a true e false. Mais seguro, mas muitos analisadores (incluindo o padrão do PyYAML) ainda usam 1.1.

O conversor usa por padrão a semântica 1.2 e avisa quando 1.1 teria mudado o resultado.

Conversão de volta de JSON para YAML

JSON para YAML geralmente é sem perda (JSON é um subconjunto da sintaxe YAML 1.2). YAML para JSON é com perda: comentários e estrutura de chave de mesclagem desaparecem. Se você planeja fazer a conversão de volta, preserve o YAML original no controle de versão.