YAML a JSON

Ejemplo de conversión

YAML:

defaults: &defaults
  timeout: 30
  retries: 3

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

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

JSON (anclas resueltas):

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

Mapeos de tipo

Cosas específicas de YAML que JSON no puede representar

• Comentarios. JSON no tiene una sintaxis estándar para comentarios. Los comentarios se eliminan.
• Flujos de múltiples documentos (--- separadores). JSON es un documento por archivo; el convertidor emite un array de documentos cuando hay múltiples.
• Anclas y alias. Resueltos y duplicados en línea.
• Claves complejas (claves de mapeo no cadena). Las claves JSON deben ser cadenas; las claves complejas se convierten a cadenas.

La trampa de 1.1 vs 1.2

• YAML 1.1 analiza yes, no, on, off, y, n como booleanos. NO como código de país se convierte silenciosamente en false.
• YAML 1.2 restringe los booleanos a true y false. Más seguro, pero muchos analizadores (incluido el predeterminado de PyYAML) aún usan 1.1.

El convertidor utiliza por defecto la semántica 1.2 y advierte cuando 1.1 habría cambiado el resultado.

Viaje de ida y vuelta de JSON a YAML

JSON a YAML suele ser sin pérdida (JSON es un subconjunto de la sintaxis YAML 1.2). YAML a JSON es con pérdida: los comentarios y la estructura de clave de fusión desaparecen. Si planeas hacer un viaje de ida y vuelta, preserva el YAML original en el control de versiones.