JSON a YAML: hacer que la salida de la máquina vuelva a ser

¿Por qué convertir JSON a YAML?

Los dos formatos contienen datos idénticos, pero se optimizan para diferentes lectores. JSON gasta caracteres entre llaves, comas y comillas; YAML los gasta en una estructura que el ojo puede seguir como una sangría. Para los datos que generan y consumen los programas, gana JSON. Para los datos que una persona edita (Helm valores, definiciones de CI, inventarios de Ansible, Docker componer archivos), YAML gana, razón por la cual esta dirección surge cada vez que los datos generados necesitan un propietario humano.

Los comentarios son lo único que no puede sobrevivir.

La conversión puede restaurar la legibilidad pero no puede restaurar la intención: la fuente JSON no tenía comentarios para transferir. Si su YAML generado será mantenido por personas, agregue un breve comentario en el encabezado que describa de dónde vino y qué lo regenera, para que nadie edite un archivo que se sobrescribirá en la próxima implementación.

Citando: donde convertido YAML se rompe silenciosamente

YAML trata varias palabras simples como valores en lugar de cadenas. Un convertidor que elimina las comillas de forma agresiva puede cambiar los tipos sin cambiar un solo carácter visible:

                country: NO        # parses as boolean false in YAML 1.1
version: 1.10      # parses as the number 1.1
time: 22:30        # parses as a sexagesimal integer
name: "on"         # quoted on purpose — must stay a string
              

Un buen resultado cita cualquier cadena que pueda leerse mal (`yes`/`no`/`on`/`off`, identificadores de apariencia numérica, valores con ceros a la izquierda, horas y fechas) en lugar de citar todo, lo que produce el muro de puntuación del que estaba tratando de escapar.

Sangría y cadenas multilínea

Dos espacios es el valor predeterminado seguro: es lo que suponen la documentación Kubernetes, las Helm plantillas y la mayoría de los editores, y sobrevive al copiar y pegar entre herramientas. El anidamiento profundo en estilo de cuatro espacios resulta difícil de escanear más allá de unos seis niveles. Las cadenas largas son la otra decisión de formato: un valor JSON con nuevas líneas incrustadas puede aparecer como una línea escapada o como un bloque escalar YAML que se lee naturalmente. Si el campo es un script de shell o un fragmento de configuración, solicite el formulario de bloque.

Clasificar claves hace que las diferencias sean significativas

El orden de las claves de objeto JSON no es significativo, por lo que los convertidores pueden reordenarlos libremente. La clasificación alfabética de las claves hace que los archivos regenerados se diferencien claramente: sin ella, un orden de implementación modificado se muestra como una reescritura de todo el archivo. Si está rastreando el YAML generado en git, la clasificación es la diferencia entre una diferencia de una línea y una de doscientas líneas.

Mantenga el viaje de ida y vuelta en un solo lugar.

Debido a que las dos direcciones son inversas, vale la pena tener ambas en la misma herramienta para que pueda convertir, editar y volver a convertir sin cambiar de contexto ni pegar su configuración en tres servicios diferentes. El conversor basado en navegador de este sitio se empareja con la herramienta YAML a JSON, funciona sin conexión y nunca carga la carga útil, lo que importa cuando el JSON en cuestión es una respuesta de producción API.