Konvertuesi JSON në YAML

Si ta përdorësh konvertuesin JSON në YAML

1. Zgjidh drejtimin: JSON → YAML ose YAML → JSON.
2. Ngjit të dhënat, ose kliko Hap një skedar për të ngarkuar një skedar .json, .yaml ose .yml (deri në 10 MB).
3. Zgjidh Shtyrjen (2 ose 4 hapësira) dhe, nëse dëshiron, Rendit çelësat alfabetikisht.
4. Kliko Konverto, ose vazhdo të shkruash: rezultati përditësohet automatikisht. Nëse hyrja është e pavlefshme, mesazhi i gabimit jep rreshtin dhe kolonën e problemit.
5. Kopjo ose shkarko rezultatin. Ndërro drejtimin e dërgon daljen përsëri në hyrje për ta konvertuar në drejtimin tjetër.

JSON dhe YAML: të njëjtat të dhëna, sintaksë e ndryshme

Në praktikë YAML është një nënbashkësi e zgjeruar e JSON: çdo dokument JSON përshkruan të dhëna që YAML mund t’i shprehë, dhe YAML shton një sintaksë më të lehtë, më të përshtatshme për t’u lexuar e redaktuar nga njerëzit. Prandaj manifestet e Kubernetes, skedarët Docker Compose, GitHub Actions dhe pipeline-t e GitLab CI, playbook-et e Ansible dhe specifikimet OpenAPI zakonisht shkruhen në YAML, ndërsa API-t dhe programet shkëmbejnë JSON.

Të njëjtat të dhëna në të dyja formatet:

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

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

JSON → YAML

Konvertuesi shkruan YAML në stil blloku: një çelës për rresht, lista me viza dhe objekte të folezuara me shtyrje. Vargjet e gjata nuk palosen kurrë, dhe vargjet me shumë rreshta përdorin stilin literal | që ndarjet e rreshtave të ruhen saktësisht. Vargjet që YAML përndryshe do t’i lexonte si tip tjetër vendosen në thonjëza: "yes", "1.0" ose "null" mbeten vargje pas një kalimi vajtje-ardhje. Rendit çelësat i rendit alfabetikisht çelësat e çdo objekti, çka i bën dy skedarë konfigurimi më të lehtë për t’u krahasuar.

YAML → JSON

YAML lexohet me skemën bazë YAML 1.2, të njëjtat rregulla që përdorin shumica e mjeteve moderne:

• true/false, numrat dhe null (ose ~) bëhen vlera JSON; yes, no, on dhe off mbeten vargje, siç kërkon specifikimi YAML 1.2.
• Ankorat dhe aliaset (&base, *base) zgjerohen, dhe çelësat e bashkimit (<<: *base), të zakonshëm në skedarët CI, mbështeten.
• Një skedar me disa dokumente të ndara me --- bëhet një varg JSON me një element për dokument, dhe një mesazh të tregon sa u bashkuan.
• Komentet hiqen, pasi JSON nuk ka komente.
• .inf dhe .nan nuk kanë ekuivalent JSON; shkruhen si vargjet "Infinity" dhe "NaN".

Për të mbrojtur shfletuesin tënd nga skedarët “billion laughs”, ku disa aliase zgjerohen në miliarda vlera, refuzohet një dokument që zgjerohet në më shumë se një milion vlera.

Gabimet e zakonshme në YAML

• Tabulime për shtyrje: YAML lejon vetëm hapësira.
• Shtyrje jokonsistente: elementet e së njëjtës listë ose të të njëjtit objekt duhet të nisin në të njëjtën kolonë.
• Hapësira që mungon pas dy pikave: key:value është një varg i vetëm, ndërsa key: value është një çift çelës-vlerë.
• Karaktere speciale pa thonjëza: një vlerë që fillon me @, një apostrof të prapmë, *, & ose !, ose që përmban : ose #, duhet vendosur në thonjëza.