Pretvarač JSON-a u YAML

Kako koristiti pretvarač JSON-a u YAML

1. Odaberi smjer: JSON → YAML ili YAML → JSON.
2. Zalijepi podatke ili klikni Otvori datoteku da učitaš datoteku .json, .yaml ili .yml (do 10 MB).
3. Odaberi Uvlačenje (2 ili 4 razmaka) i, ako želiš, Sortiraj ključeve abecedno.
4. Klikni Pretvori ili samo nastavi tipkati: rezultat se osvježava automatski. Ako je unos neispravan, poruka o grešci navodi redak i stupac problema.
5. Kopiraj ili preuzmi rezultat. Zamijeni smjer šalje izlaz natrag u unos da ga pretvoriš u drugom smjeru.

JSON i YAML: isti podaci, drukčija sintaksa

YAML je u praksi nadskup JSON-a: svaki JSON dokument opisuje podatke koje YAML može izraziti, a YAML dodaje lakšu sintaksu koju ljudi lakše čitaju i uređuju. Zato se Kubernetes manifesti, Docker Compose datoteke, GitHub Actions i GitLab CI procesi, Ansible playbookovi i OpenAPI specifikacije obično pišu u YAML-u, dok API-ji i programi razmjenjuju JSON.

Isti podaci u oba formata:

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

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

JSON → YAML

Pretvarač piše YAML blok-stila: jedan ključ po retku, popise s crticama i uvučene ugniježđene objekte. Dugi nizovi se nikada ne lome, a višeredni nizovi koriste doslovni stil | pa se prijelomi redaka čuvaju točno. Nizovi koje bi YAML inače pročitao kao drugi tip stavljaju se pod navodnike: "yes", "1.0" ili "null" ostaju nizovi nakon povratnog puta. Sortiraj ključeve abecedno slaže ključeve svakog objekta, što olakšava usporedbu dviju konfiguracijskih datoteka.

YAML → JSON

YAML se čita jezgrenom shemom YAML 1.2, istim pravilima koja koristi većina modernih alata:

• true/false, brojevi i null (ili ~) postaju JSON vrijednosti; yes, no, on i off ostaju nizovi, kako zahtijeva specifikacija YAML 1.2.
• Sidra i aliasi (&base, *base) se proširuju, a spojni ključevi (<<: *base), uobičajeni u CI datotekama, podržani su.
• Datoteka s više dokumenata odvojenih s --- postaje JSON polje s jednim elementom po dokumentu, a poruka javlja koliko ih je spojeno.
• Komentari se odbacuju jer JSON nema komentare.
• .inf i .nan nemaju JSON ekvivalent; zapisuju se kao nizovi "Infinity" i "NaN".

Da zaštitimo tvoj preglednik od datoteka tipa „billion laughs“, u kojima se nekoliko aliasa širi u milijarde vrijednosti, dokument koji se širi na više od milijun vrijednosti se odbija.

Česte YAML greške

• Tabulatori za uvlačenje: YAML dopušta samo razmake.
• Nedosljedno uvlačenje: stavke istog popisa ili objekta moraju počinjati u istom stupcu.
• Razmak koji nedostaje iza dvotočke: key:value je jedan niz, dok je key: value par ključ-vrijednost.
• Posebni znakovi bez navodnika: vrijednost koja počinje s @, obrnutim jednostrukim navodnikom, *, & ili !, ili koja sadrži : ili #, mora biti pod navodnicima.