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š .json, .yaml ili .yml datoteku (do 10 MB).
3. Odaberi Uvlačenje (2 ili 4 razmaka) i, ako želiš, Sortiraj ključeve po abecedi.
4. Klikni Pretvori ili samo nastavi tipkati: rezultat se ažurira automatski. Ako je ulaz neispravan, poruka o grešci navodi red i kolonu problema.
5. Kopiraj ili preuzmi rezultat. Zamijeni smjer šalje izlaz nazad u ulaz da ga pretvoriš u suprotnom smjeru.

JSON i YAML: isti podaci, različita 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 pipelineovi, 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 u blok stilu: jedan ključ po redu, liste s crticama i uvučene ugniježđene objekte. Dugi stringovi se nikada ne prelamaju, a višeredni stringovi koriste doslovni stil | da se prelomi redova sačuvaju tačno. Stringovi koje bi YAML inače pročitao kao drugi tip stavljaju se pod navodnike: "yes", "1.0" ili "null" ostaju stringovi nakon povratnog puta. Sortiraj ključeve poredi ključeve svakog objekta po abecedi, što olakšava poređenje dvije konfiguracijske datoteke.

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 stringovi, kako zahtijeva specifikacija YAML 1.2.
• Sidra i aliasi (&base, *base) se proširuju, a ključevi spajanja (<<: *base), uobičajeni u CI datotekama, podržani su.
• Datoteka s više dokumenata razdvojenih sa --- postaje JSON niz s jednim elementom po dokumentu, a poruka kaže koliko ih je spojeno.
• Komentari se odbacuju, jer JSON nema komentare.
• .inf i .nan nemaju JSON ekvivalent; zapisuju se kao stringovi "Infinity" i "NaN".

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

Česte greške u YAML-u

• Tabulatori za uvlačenje: YAML dozvoljava samo razmake.
• Nedosljedno uvlačenje: stavke iste liste ili objekta moraju počinjati u istoj koloni.
• Razmak koji nedostaje iza dvotačke: key:value je jedan string, dok je key: value par ključ-vrijednost.
• Posebni znakovi bez navodnika: vrijednost koja počinje s @, obrnutim apostrofom, *, & ili !, ili koja sadrži : ili #, mora biti pod navodnicima.