Convertitore JSON in YAML

Cos'è la conversione da JSON a YAML?

La conversione da JSON a YAML trasforma i dati da JavaScript Object Notation in YAML Ain't Markup Language. Entrambi i formati rappresentano le stesse strutture dati (oggetti, array, stringhe, numeri, booleani, null), ma utilizzano una sintassi diversa. JSON si basa su parentesi graffe, parentesi quadre e virgole. YAML usa l'indentazione e le interruzioni di riga, producendo un output che si avvicina al testo semplice. A differenza di XML, nessuno dei due formati richiede uno schema.

YAML è stato progettato come formato di serializzazione dei dati orientato alla leggibilità umana. È il linguaggio di configurazione predefinito per i manifest Kubernetes, i file Docker Compose, i playbook Ansible, i workflow GitHub Actions e molti sistemi CI/CD. Quando i dati di origine sono in JSON e il sistema di destinazione si aspetta YAML, serve un convertitore che preservi ogni valore, tipo e livello di annidamento senza perdita di dati.

Convertire JSON in YAML online è utile quando si ricevono risposte API o dati esportati in JSON e si devono incollare in un file di configurazione YAML. La conversione è senza perdita di dati per tutti i tipi JSON standard: stringhe, numeri, booleani, null, array e oggetti si mappano direttamente nei loro equivalenti YAML. I valori che contengono due punti o caratteri speciali vengono automaticamente racchiusi tra virgolette per garantire un output YAML valido.

Perché convertire JSON in YAML?

YAML è lo standard per i file di configurazione; JSON è ciò che restituiscono le API. Convertire tra i due formati permette di usare quello giusto per ogni situazione senza riscrivere i dati a mano.

Casi d'uso della conversione JSON in YAML

Confronto JSON vs YAML

JSON e YAML possono rappresentare gli stessi dati, ma la loro sintassi e le loro funzionalità differiscono in modi che contano per casi d'uso specifici.

Insidie di YAML dopo la conversione

YAML ha regole di analisi che sorprendono gli sviluppatori abituati a JSON. Questi quattro problemi causano la maggior parte dei bug quando si lavora con output convertito.

Esempi di codice

La conversione programmatica da JSON a YAML richiede una libreria di serializzazione YAML nella maggior parte dei linguaggi. La libreria standard gestisce il parsing JSON; l'output YAML necessita di un pacchetto aggiuntivo.

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))"

Domande frequenti