Pretvoriti između JSON i YAML

Ovaj alat pretvara YAML dokument u JSON i obrnuto, čuvajući strukturu podataka (objekti, tablice, skalarni tipovi). Konverzija JSON-a u YAML, ili YAML-a u JSON, uobičajena je operacija u razvoju: generiramo OpenAPI YAML datoteku iz JSON specifikacije, konvertiramo izlaz REST API-ja u YAML da ga predamo konfiguracijskom repozitoriju, prevodimo Kubernetes YAML manifest u JSON da ga proslijedimo kubectl --dry-run=client -o json ili poravnavamo GitHub tijek rada Radnje s JSON shemom. Šire gledano, to je most između svijeta razmjene podataka (JSON) i svijeta konfiguracije koja se može ručno uređivati (YAML).

JSON i YAML rješavaju slične potrebe, ali različite slučajeve upotrebe. Sljedeća tablica sažima glavne tehničke razlike, korisne za odabir između to dvoje ovisno o kontekstu.

JSON je potreban kad god program komunicira s drugim programom. Njegovi tipični slučajevi upotrebe:

• REST i GraphQL API-ji: sadržaj zahtjeva i odgovora.
• Razmjena podataka između mikroservisa i redova poruka.
• Nativni JavaScript kôd: JSON.parse i JSON.stringify bez ovisnosti.
• Pohrana na strani preglednika: localStorage, sessionStorage, IndexedDB.
• AJAX i fetch zahtjevi.
• Binarne ili varijante usmjerene na tok: BSON (MongoDB), JSON Lines (dnevnici, ML skupovi podataka), MessagePack.
• Konfiguracija JS / TS alata: package.json, tsconfig.json, composer.json.

YAML je potreban čim čovjek redovito uređuje datoteku. Njegovi tipični slučajevi upotrebe:

• Docker Compose (docker-compose.yml) i slaganje profila.
• Kubernetes manifesti (Implementacija, Usluga, Ingress, Helm karte).
• Ansible playbooks and inventory.
• CI/CD cjevovodi: GitHub Actions, GitLab CI, CircleCI, Bitbucket cjevovodi.
• OpenAPI / Swagger i AsyncAPI specifikacije.
• Konfiguracija aplikacije s komentarima (Symfony, Spring Boot, Rails) gdje su komentari korisni.
• Datoteke koje se često uređuju ručno, gdje sažetost i čitljivost imaju prednost nad brzinom analize.

YAML je popustljiviji od JSON-a, što ga čini moćnim, ali podmuklim formatom. Najčešće zamke:

• Uvlačenje: specifikacijom su zabranjeni tabulatori, važeći su samo razmaci. Miješanje to dvoje ili promjena broja razmaka u istom bloku prekida raščlanjivanje.
• Automatsko skalarno prisiljavanje: da, ne, on, off, true, false, null, None, ~ analiziraju se kao Booleovi ili null. Primjer zamke: poštanski broj 01234 bez navodnika postaje cijeli broj 1234, a naziv zemlje NO (Norveška) postaje false. Dvosmislene nizove uvijek stavite u navodnike.
• Višeredni nizovi: | (blokovni literal) zadržava prijelome redaka kakvi jesu, dok > (presavijen) zamjenjuje prijelome redaka razmacima. Zastavice žvakanja - i + prilagođavaju ponašanje pri završnom skoku.
• YAML 1.1 nasuprot 1.2: 1.1 (još uvijek vrlo uobičajen, na primjer putem PyYAML-a prema zadanim postavkama) tretira yes/no/on/off kao Booleove vrijednosti, koje je 1.2 uklonio. Ponašanje se također razlikuje prema brojevima baze 8.
• Implicirani datumi: 2024-01-15 bez navodnika neki parseri tumače kao objekt datuma, a ne kao niz.

Isti dokument, izražen u JSON-u pa u YAML-u. Jednostavna konfiguracija aplikacije s njezinim ovisnostima i okolinom:

JSON verzija

{
    "ime": "cdrn-aplikacija",
    "verzija": "1.14.2",
    "okoliš": "proizvodnja",
    "ovisnosti": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doktrina/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": netočno
}

Ekvivalentna YAML verzija

# Konfiguracija aplikacije
naziv: cdrn-app
verzija: 1.14.2
okolina: proizvodnja
ovisnosti:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doktrina/orm: '^3.0'
karakteristike:
    - predmemorija
    - poštar
    - rep
debug: false

YAML verzija je oko 25% kraća u znakovima, prihvaća vodeći komentar i čita se kao popis svojstava bez sintaktičke buke.

Koraci za pretvaranje podataka:

1. Zalijepite svoj izvorni dokument (JSON ili YAML) u polje za unos.
2. Odaberite željeni smjer konverzije (JSON u YAML ili YAML u JSON).
3. Kliknite gumb za pretvaranje: formatirani rezultat pojavljuje se u izlaznom području.
4. Provjerite prikaz, a zatim upotrijebite gumb za kopiranje da dohvatite rezultat u međuspremnik.

Pretvorba se provodi lokalno u vašem pregledniku ili putem namjenskog poslužitelja, ovisno o alatu: ne zadržavaju se osjetljivi podaci.