Konvertor JSON na YAML a späť

Ako používať konvertor JSON na YAML

1. Vyber smer: JSON → YAML alebo YAML → JSON.
2. Vlož údaje, alebo klikni na Otvoriť súbor a načítaj súbor .json, .yaml alebo .yml (do 10 MB).
3. Vyber Odsadenie (2 alebo 4 medzery) a podľa chuti Zoradiť kľúče abecedne.
4. Klikni na Konvertovať, alebo len píš ďalej: výsledok sa aktualizuje automaticky. Ak je vstup neplatný, chybová správa uvádza riadok a stĺpec problému.
5. Skopíruj alebo stiahni výsledok. Obrátiť smer pošle výstup späť do vstupu, aby si ho mohol konvertovať opačným smerom.

JSON a YAML: rovnaké údaje, iná syntax

YAML je v praxi nadmnožina JSON: každý dokument JSON opisuje údaje, ktoré YAML vie vyjadriť, a YAML pridáva ľahšiu syntax, ktorú sa ľahšie číta a upravuje. Preto sa manifesty Kubernetes, súbory Docker Compose, pracovné postupy GitHub Actions a pipeline GitLab CI, playbooky Ansible aj špecifikácie OpenAPI zvyčajne píšu v YAML, kým API a programy si vymieňajú JSON.

Rovnaké údaje v oboch formátoch:

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

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

JSON → YAML

Konvertor zapisuje YAML v blokovom štýle: jeden kľúč na riadok, zoznamy s pomlčkami a odsadené vnorené objekty. Dlhé reťazce sa nikdy nezalamujú a viacriadkové reťazce používajú doslovný štýl |, aby sa zalomenia riadkov zachovali presne. Reťazce, ktoré by YAML inak prečítal ako iný typ, sa uzatvárajú do úvodzoviek: "yes", "1.0" alebo "null" ostanú po spiatočnej ceste reťazcami. Zoradiť kľúče abecedne zoradí kľúče každého objektu, vďaka čomu sa dva konfiguračné súbory lepšie porovnávajú.

YAML → JSON

YAML sa číta podľa základnej schémy YAML 1.2, teda podľa rovnakých pravidiel, aké používa väčšina moderných nástrojov:

• true/false, čísla a null (alebo ~) sa stanú hodnotami JSON; yes, no, on a off ostanú reťazcami, ako vyžaduje špecifikácia YAML 1.2.
• Kotvy a aliasy (&base, *base) sa rozvinú a podporované sú aj zlučovacie kľúče (<<: *base), bežné v súboroch CI.
• Súbor s viacerými dokumentmi oddelenými --- sa stane poľom JSON s jedným prvkom na dokument a správa ti oznámi, koľko ich bolo zlúčených.
• Komentáre sa zahodia, pretože JSON komentáre nemá.
• .inf a .nan nemajú ekvivalent v JSON; zapíšu sa ako reťazce "Infinity" a "NaN".

Na ochranu prehliadača pred súbormi typu „billion laughs“, v ktorých sa niekoľko aliasov rozvinie na miliardy hodnôt, sa dokument rozvinutý na viac než milión hodnôt odmietne.

Časté chyby v YAML

• Tabulátory na odsadenie: YAML povoľuje iba medzery.
• Nejednotné odsadenie: položky toho istého zoznamu alebo objektu musia začínať v rovnakom stĺpci.
• Chýbajúca medzera za dvojbodkou: key:value je jeden reťazec, kým key: value je dvojica kľúč a hodnota.
• Neuzavreté špeciálne znaky: hodnota, ktorá začína @, spätným apostrofom, *, & alebo !, alebo obsahuje : či #, musí byť v úvodzovkách.