JSON to YAML

Co je převod JSON na YAML?

Převod JSON na YAML transformuje data z formátu JavaScript Object Notation do formátu YAML Ain't Markup Language. Oba formáty reprezentují stejné datové struktury (objekty, pole, řetězce, čísla, logické hodnoty, null), ale používají odlišnou syntaxi. JSON se opírá o složené závorky, hranaté závorky a čárky. YAML používá odsazení a konce řádků, čímž vytváří výstup, který je blíže prostému textu. Na rozdíl od XML ani jeden formát nevyžaduje schéma.

YAML byl navržen jako datový serializační formát přívětivý pro člověka. Je to výchozí konfigurační jazyk pro Kubernetes manifesty, Docker Compose soubory, Ansible playbooky, GitHub Actions workflows a mnoho CI/CD systémů. Pokud jsou vaše zdrojová data ve formátu JSON a váš cílový systém očekává YAML, potřebujete převodník, který spolehlivě zachová každou hodnotu, typ a úroveň vnoření přesně bez ztráty dat.

Převod JSON na YAML online je užitečný, když obdržíte API odpovědi nebo exportovaná data ve formátu JSON a potřebujete je vložit do konfiguračního souboru YAML. Převod je bezztrátový pro všechny standardní typy JSON: řetězce, čísla, logické hodnoty, null, pole a objekty se mapují přímo na jejich YAML ekvivalenty. Hodnoty obsahující dvojtečky nebo speciální znaky jsou automaticky uzavřeny do uvozovek, takže výstup je platný YAML.

Proč převádět JSON na YAML?

YAML je standard pro konfigurační soubory; JSON je to, co vrací API. Převod mezi nimi vám umožňuje používat správný formát pro každý úkol bez ručního přepisování dat.

Případy použití JSON na YAML

Srovnání JSON a YAML

JSON a YAML mohou reprezentovat stejná data, ale jejich syntaxe a možnosti se liší způsoby, které jsou důležité pro konkrétní případy použití.

Záludnosti YAML po převodu

YAML má pravidla parsování, která překvapují vývojáře zvyklé na JSON. Tyto čtyři problémy způsobují nejvíce chyb při práci s převedeným výstupem.

Příklady kódu

Programový převod JSON na YAML vyžaduje v většině jazyků knihovnu pro serializaci YAML. Standardní knihovna zvládá parsování JSON; pro výstup YAML je potřeba další balíček.

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

Časté dotazy