JSON vers YAML

Qu'est-ce que la conversion JSON vers YAML ?

La conversion JSON vers YAML transforme des données du format JavaScript Object Notation vers YAML Ain't Markup Language. Les deux formats représentent les mêmes structures de données (objets, tableaux, chaînes, nombres, booléens, null), mais avec une syntaxe différente. JSON s'appuie sur les accolades, les crochets et les virgules. YAML utilise l'indentation et les sauts de ligne, produisant une sortie qui se lit comme du texte brut. Contrairement à XML, aucun des deux formats n'exige de schéma.

YAML a été conçu comme un format de sérialisation de données lisible par l'humain. C'est le langage de configuration par défaut pour les manifestes Kubernetes, les fichiers Docker Compose, les playbooks Ansible, les workflows GitHub Actions et de nombreux systèmes CI/CD. Lorsque vos données source sont en JSON et que votre système cible attend du YAML, vous avez besoin d'un convertisseur qui préserve fidèlement chaque valeur, type et niveau d'imbrication, sans perte de données.

Convertir JSON vers YAML en ligne est utile lorsque vous recevez des réponses d'API ou des données exportées en JSON et que vous devez les coller dans un fichier de configuration YAML. La conversion est sans perte pour tous les types JSON standard : chaînes, nombres, booléens, null, tableaux et objets correspondent directement à leurs équivalents YAML. Les valeurs contenant des deux-points ou des caractères spéciaux sont automatiquement mises entre guillemets pour garantir un YAML valide.

Pourquoi convertir JSON vers YAML ?

YAML est le standard pour les fichiers de configuration ; JSON est ce que renvoient les API. Les convertir permet d'utiliser le bon format pour chaque tâche sans réécrire les données à la main.

Cas d'utilisation JSON vers YAML

Comparaison JSON vs YAML

JSON et YAML peuvent représenter les mêmes données, mais leur syntaxe et leurs capacités diffèrent de façon importante selon les cas d'usage.

Pièges YAML après conversion

YAML possède des règles d'analyse qui surprennent les développeurs venant de JSON. Ces quatre problèmes causent le plus de bugs lorsqu'on travaille avec une sortie convertie.

Exemples de code

Convertir JSON vers YAML par programme nécessite une bibliothèque de sérialisation YAML dans la plupart des langages. La bibliothèque standard gère l'analyse JSON ; la sortie YAML requiert un paquet supplémentaire.

import YAML from 'js-yaml'

const json = '{"host":"localhost","port":3000,"debug":true}'
const obj = JSON.parse(json)
const yamlStr = YAML.dump(obj, { indent: 2 })
console.log(yamlStr)
// → host: localhost
// → port: 3000
// → debug: true

import json, yaml

json_str = '{"host": "localhost", "port": 3000, "debug": true}'
data = json.loads(json_str)
yaml_str = yaml.dump(data, default_flow_style=False, sort_keys=False)
print(yaml_str)
# → host: localhost
# → port: 3000
# → debug: true

package main

import (
    "encoding/json"
    "fmt"
    "gopkg.in/yaml.v3"
)

func main() {
    jsonStr := `{"host":"localhost","port":3000,"debug":true}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    yamlBytes, _ := yaml.Marshal(data)
    fmt.Println(string(yamlBytes))
    // → debug: true
    // → host: localhost
    // → port: 3000
}

# Using yq (https://github.com/mikefarah/yq)
echo '{"host":"localhost","port":3000}' | yq -P
# → host: localhost
# → port: 3000

# Using Python one-liner
echo '{"host":"localhost","port":3000}' | python3 -c "import sys,json,yaml; print(yaml.dump(json.load(sys.stdin), default_flow_style=False))"

Questions fréquentes