Převodník JSON na YAML

Jak používat převodník JSON na YAML

1. Zvol směr: JSON → YAML nebo YAML → JSON.
2. Vlož data, nebo klikni na Otevřít soubor a načti soubor .json, .yaml či .yml (do 10 MB).
3. Vyber Odsazení (2 nebo 4 mezery) a případně Seřadit klíče podle abecedy.
4. Klikni na Převést, nebo prostě piš dál: výsledek se aktualizuje automaticky. Pokud je vstup neplatný, chybové hlášení uvádí řádek a sloupec problému.
5. Výsledek zkopíruj nebo stáhni. Obrátit směr pošle výstup zpět do vstupu, abys ho mohl převést opačným směrem.

JSON a YAML: stejná data, jiná syntaxe

YAML je v praxi nadmnožinou JSON: každý dokument JSON popisuje data, která YAML umí vyjádřit, a YAML k tomu přidává lehčí syntaxi, kterou lidé snáz čtou a upravují. Proto se manifesty Kubernetes, soubory Docker Compose, pipeline GitHub Actions a GitLab CI, playbooky Ansible a specifikace OpenAPI obvykle píší v YAML, zatímco API a programy si vyměňují JSON.

Stejná data v obou formátech:

{"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}

name: web
ports:
  - 80
  - 443
env:
  DEBUG: false

JSON → YAML

Převodník zapisuje YAML v blokovém stylu: jeden klíč na řádek, seznamy s pomlčkami a vnořené objekty odsazené. Dlouhé řetězce se nikdy nezalamují a víceřádkové řetězce používají doslovný styl |, aby se konce řádků zachovaly přesně. Řetězce, které by YAML jinak četl jako jiný typ, se uvozují: "yes", "1.0" nebo "null" zůstanou po cestě tam a zpět řetězci. Seřadit klíče seřadí klíče každého objektu podle abecedy, což usnadňuje porovnání dvou konfiguračních souborů.

YAML → JSON

YAML se čte podle základního schématu YAML 1.2, tedy podle stejných pravidel jako většina moderních nástrojů:

• true/false, čísla a null (nebo ~) se změní na hodnoty JSON. yes, no, on a off zůstanou řetězci, jak vyžaduje specifikace YAML 1.2.
• Kotvy a aliasy (&base, *base) se rozbalí a slučovací klíče (<<: *base), časté v souborech CI, jsou podporovány.
• Soubor s několika dokumenty oddělenými --- se změní na pole JSON s jedním prvkem na dokument a zpráva ti řekne, kolik jich bylo sloučeno.
• Komentáře se zahazují, protože JSON komentáře nemá.
• .inf a .nan nemají v JSON ekvivalent a zapisují se jako řetězce "Infinity" a "NaN".

Aby byl tvůj prohlížeč chráněn před soubory typu „billion laughs“, v nichž se několik aliasů rozbalí na miliardy hodnot, dokument, který se rozbalí na víc než milion hodnot, se odmítne.

Časté chyby v YAML

• Tabulátory pro odsazení: YAML povoluje jen mezery.
• Nejednotné odsazení: položky téhož seznamu nebo objektu musí začínat ve stejném sloupci.
• Chybějící mezera za dvojtečkou: key:value je jediný řetězec, zatímco key: value je dvojice klíč–hodnota.
• Speciální znaky bez uvozovek: hodnota, která začíná znakem @, zpětným apostrofem, *, & nebo !, nebo která obsahuje : či #, musí být uvozena.