JSON-i ja YAML-i teisendaja

Kuidas JSON-i ja YAML-i teisendajat kasutada

1. Vali suund: JSON → YAML või YAML → JSON.
2. Kleebi andmed või klõpsa nuppu Ava fail, et laadida .json-, .yaml- või .yml-fail (kuni 10 MB).
3. Vali Taane (2 või 4 tühikut) ja soovi korral Sorteeri võtmed tähestikuliselt.
4. Klõpsa Teisenda või lihtsalt jätka kirjutamist: tulemus uueneb automaatselt. Kui sisend on vigane, annab veateade probleemi rea ja veeru.
5. Kopeeri tulemus või laadi see alla. Vaheta suund saadab väljundi tagasi sisendisse, et teisendada seda vastupidi.

JSON ja YAML: samad andmed, erinev süntaks

YAML on praktikas JSON-i ülemhulk: iga JSON-dokument kirjeldab andmeid, mida YAML suudab väljendada, ja YAML lisab kergema süntaksi, mida on inimesel lihtsam lugeda ja muuta. Seepärast kirjutatakse Kubernetese manifeste, Docker Compose’i faile, GitHub Actionsi ja GitLab CI töövooge, Ansible’i playbook’e ning OpenAPI spetsifikatsioone tavaliselt YAML-is, samal ajal kui API-d ja programmid vahetavad JSON-i.

Samad andmed mõlemas vormingus:

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

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

JSON → YAML

Teisendaja kirjutab plokistiilis YAML-i: üks võti rea kohta, loendid kriipsudega ja pesastatud objektid taandatud. Pikki stringe ei voldita kunagi ning mitmerealised stringid kasutavad literaalset | stiili, et reavahetused säiliksid täpselt. Stringid, mida YAML muidu loeks muu tüübina, pannakse jutumärkidesse: "yes", "1.0" või "null" jäävad pärast edasi-tagasi teisendust stringideks. Sorteeri võtmed järjestab iga objekti võtmed tähestikuliselt, mis teeb kahe seadistusfaili võrdlemise lihtsamaks.

YAML → JSON

YAML loetakse YAML 1.2 põhiskeemiga, samade reeglitega, mida kasutab enamik tänapäevaseid tööriistu:

• true/false, arvud ja null (või ~) muutuvad JSON-i väärtusteks; yes, no, on ja off jäävad stringideks, nagu YAML 1.2 spetsifikatsioon nõuab.
• Ankrud ja aliased (&base, *base) laiendatakse ning ühendusvõtmed (<<: *base), mis on CI-failides levinud, on toetatud.
• Fail mitme dokumendiga, mis on eraldatud märgiga ---, muutub JSON-massiiviks, kus on üks element dokumendi kohta, ning teade ütleb, mitu dokumenti ühendati.
• Kommentaarid jäetakse ära, sest JSON-is kommentaare pole.
• .inf ja .nan ei oma JSON-is vastet; need kirjutatakse stringidena "Infinity" ja "NaN".

Et kaitsta sinu brauserit „miljardi naeru“ failide eest, kus mõned aliased laienevad miljarditeks väärtusteks, lükatakse tagasi dokument, mis laieneb üle miljoni väärtuseni.

Levinud YAML-i vead

• Tabulaatorid taandeks: YAML lubab ainult tühikuid.
• Ebajärjekindel taane: sama loendi või objekti elemendid peavad algama samast veerust.
• Puuduv tühik koolonil järel: key:value on üks string, samal ajal kui key: value on võtme-väärtuse paar.
• Jutumärkideta erimärgid: väärtus, mis algab märgiga @, tagurpidi ülakomaga, *, & või ! või mis sisaldab : või #, tuleb panna jutumärkidesse.