Konvertēt starp JSON un YAML

JSON un YAML risina līdzīgas vajadzības, taču atšķiras lietošanas gadījumi. Nākamajā tabulā ir apkopotas galvenās tehniskās atšķirības, kas ir noderīgas, izvēloties vienu no tām atkarībā no konteksta.

JSON ir nepieciešams ikreiz, kad programma sazinās ar citu programmu. Tās tipiskie lietošanas gadījumi:

• REST un GraphQL API: pieprasījumu un atbilžu lietderīgās slodzes.
• Datu apmaiņa starp mikropakalpojumiem un ziņojumu rindām.
• Vietējais JavaScript kods: JSON.parse un JSON.stringify bez atkarībām.
• Pārlūkprogrammas krātuve: localStorage, sessionStorage, IndexedDB.
• AJAX un ieneses pieprasījumi.
• Bināri vai uz plūsmu orientēti varianti: BSON (MongoDB), JSON līnijas (žurnāli, ML datu kopas), MessagePack.
• JS/TS rīku konfigurācija: package.json, tsconfig.json, composer.json.

YAML ir nepieciešams, tiklīdz cilvēks regulāri rediģē failu. Tās tipiskie lietošanas gadījumi:

• Docker Compose (docker-compose.yml) un sakraujiet profilus.
• Kubernetes manifesti (izvietošanas, apkalpošanas, ienākšanas, stūres diagrammas).
• Iespējamas rokasgrāmatas un krājumi.
• CI/CD cauruļvadi: GitHub Actions, GitLab CI, CircleCI, Bitbucket cauruļvadi.
• OpenAPI/Swagger un AsyncAPI specifikācijas.
• Anotētas lietojumprogrammas konfigurācija (Symfony, Spring Boot, Rails), kur komentāri ir noderīgi.
• Faili, kas bieži tiek rediģēti ar roku, kur kodolīgums un lasāmība ir svarīgāki par parsēšanas ātrumu.

YAML ir pieļaujamāks nekā JSON, padarot to par spēcīgu, bet nodevīgu formātu. Visbiežāk sastopamās nepilnības:

• Atkāpe: specifikācijas aizliedz tabulēšanas izmantošanu, ir derīgas tikai atstarpes. Sajaucot abus vai mainot atstarpju skaitu vienā blokā, parsēšana tiek pārtraukta.
• Automātiska skalāra piespiešana: jā, nē, ieslēgts, izslēgts, patiess, false, null, nav, nulles vai booles tiek parsētas kā ~. Slazda piemērs: pasta indekss 01234 bez pēdiņām kļūst par veselu skaitli 1234, un valsts nosaukums NO (Norvēģija) kļūst par false. Neviennozīmīgas virknes vienmēr iekļaujiet pēdiņās.
• Daudzrindu virknes: | (bloka burts) saglabā rindu pārtraukumus tādus, kādi tie ir, savukārt > (salocīts) rindiņas pārtraukumus aizstāj ar atstarpēm. Mainošie karodziņi - un + pielāgo darbību pēdējā lēcienā.
• YAML 1.1 pret 1.2: 1.1 (joprojām ļoti bieži, piemēram, izmantojot PyYAML pēc noklusējuma) uzskata jā/nē/ieslēgts/izslēgts kā Būla vērtības, kuras 1.2 noņēma. Uzvedība atšķiras arī no 8. bāzes skaitļiem.
• Iedomātie datumi: 2024-01-15 bez pēdiņām daži parsētāji interpretē kā datuma objektu, nevis kā virkni.

Tas pats dokuments, kas izteikts JSON, pēc tam YAML. Vienkārša lietojumprogrammas konfigurācija ar tās atkarībām un vidi:

JSON versija

{
    "name": "cdrn-app",
    "versija": "1.14.2",
    "vide": "ražošana",
    "atkarības": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doktrīna/orm": "^3.0"
    },
    "funkcijas": ["kešatmiņa", "pasts", "rinda"],
    "atkļūdošana": nepatiess
}

Ekvivalenta YAML versija

# Lietojumprogrammas konfigurācija
nosaukums: cdrn-app
versija: 1.14.2
vide: ražošana
atkarības:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doktrīna/orm: '^3.0'
funkcijas:
    - kešatmiņa
    - pastnieks
    - asti
atkļūdošana: false

YAML versijai ir aptuveni par 25% mazākas rakstzīmes, tā pieņem vadošo komentāru un skan kā rekvizītu saraksts bez sintaktiskā trokšņa.

Datu konvertēšanas darbības:

1. Ievades laukā ielīmējiet avota dokumentu (JSON vai YAML).
2. Atlasiet vēlamo konversijas virzienu (JSON uz YAML vai YAML uz JSON).
3. Noklikšķiniet uz konvertēšanas pogas: formatētais rezultāts tiek parādīts izvades apgabalā.
4. Pārbaudiet atveidojumu un pēc tam izmantojiet kopēšanas pogu, lai izgūtu rezultātu starpliktuvē.

Konvertēšana tiek veikta lokāli jūsu pārlūkprogrammā vai izmantojot īpašu servera maršrutu atkarībā no rīkiem: sensitīvi dati netiek saglabāti.