Brezplačni pretvornik

JSON v YAML pretvornik

Pretvorite strukturo JSON v čisto obliko YAML. Idealno za manifeste Kubernetes in konfiguracije v oblaku.

oz

O tem orodju

Prehod z JSON na YAML je večinoma namenjen temu, da naredimo podatke bolj berljivi za ljudi. Oba formata opisujeta enake vrste struktur – objekte/zemljevide, nize/zaporedja, skalarje – vendar sintaksa YAML, ki temelji na zamikih, neobvezno navajanje in podpora za komentarje olajšajo ročno skeniranje in urejanje. Konfiguracijske datoteke so kanoničen primer uporabe: manifesti Kubernetes, delovni tokovi CI, priročniki Ansible in na desetine drugih orodij so izbrali YAML posebej zato, ker so njihovi primarni urejevalci ljudje.

Ta pretvornik uporablja js-yaml za serializacijo razčlenjenega predmeta JSON v YAML. Rezultat ohranja strukturo podatkov natančno med uporabo konvencij YAML: zamik za gnezdenje, seznami za nize, pari ključ-vrednost za lastnosti objekta. Strogo dvojno navajanje JSON je sproščeno; v izhodu so navedeni samo nizi, ki vsebujejo posebne znake ali so videti kot drugi tipi.

Pretvorba ohranja informacije, razen kjer YAML doda izraznost, ki je JSON ni imel. Komentarjev ni mogoče rekonstruirati (JSON jih ni imel). Sklici na sidra in vzdevke bi lahko potencialno stisnili ponavljajoče se strukture, vendar niso ustvarjeni samodejno; izhod razširi vse reference v vrstici.

Zakaj pretvoriti JSON v YAML

YAML je bistveno bolj berljiv kot JSON za ljudi, ki urejajo konfiguracijo. Zamik nadomesti gnezdenje oklepajev, narekovaji so neobvezni za preproste nize, komentarji pa lahko dokumentirajo neočitne nastavitve. Za datoteke, ki jih vzdržujejo ljudje – konfiguracija aplikacije, infrastruktura kot koda, izgradnja cevovodov – je YAML skoraj vedno pravi ciljni format.

Sodobna infrastrukturna orodja v veliki večini dajejo prednost YAML. Kubernetes, Helm charts, Ansible, GitHub Actions, GitLab CI, Docker Compose in številna druga orodja raje ali zahtevajo YAML. Pretvarjanje izvozov JSON iz enega sistema v konfiguracijo YAML za drugega je rutinski korak integracije.

Kako uporabljati

Prilepite JSON, pridobite YAML.

  1. Dodajte svoj JSON: Prilepite besedilo JSON ali spustite datoteko. Vnos mora biti veljaven JSON; pretvornik ne poskuša razčleniti JSON podobnega vnosa, ki krši spec.
  2. Izberite možnosti: Privzeta velikost zamika je 2 presledka, kar je najpogostejša konvencija YAML. Slog poteka (podoben kompaktnemu JSON) v primerjavi s slogom bloka (temelji na zamiku) preklopi videz izpisa — blok je človeku prijazna privzeta nastavitev.
  3. Pretvori: Funkcija dump js-yaml serializira razčlenjeno drevo JSON v YAML. Narejanje nizov se uporablja samo, kjer je potrebno; kompleksni nizi ostanejo berljivi.
  4. Prenesite ali kopirajte: Shrani kot .yml ali kopiraj v odložišče. Izhod je veljaven YAML 1.2, pripravljen za vsakega uporabnika YAML.

Pogosti primeri uporabe

Tehnične podrobnosti

Funkcija dump js-yaml hodi po drevesu objektov JavaScript in oddaja YAML z nastavljivim oblikovanjem. Globina zamika, širina vrstice, prag sloga toka in obdelava narekovajev so vsi parametri. Privzete nastavitve ustvarijo YAML v slogu blokov z zamikom 2 presledkov, kar je najpogostejša konvencija.

Navajanje nizov sledi pravilom YAML: nizi, ki so videti kot drugi tipi (števila, logične vrednosti, nič, datumi), so narekovani, da vsilijo interpretacijo nizov; nizi, ki vsebujejo posebne znake (dvopičja, ključi, začetni pomišljaji), so v narekovajih; preprosti abecedni nizi ostanejo brez narekovajev.

Izhod je združljiv z YAML 1.2 in razčlenjuje čisto z js-yaml, PyYAML in drugimi večjimi knjižnicami YAML. Idempotentna povratna potovanja (JSON → YAML → JSON) ohranijo podatke, čeprav predstavitev YAML izbere kanonično oblikovanje, ki se lahko razlikuje od ročno napisanega ekvivalenta.

Najboljše prakse

Pogosta vprašanja

Ali pretvorba JSON v YAML spremeni vsebino?
Vsebina je ohranjena čim bolj natančno. Vendar pa nekatere funkcije, specifične za obliko, morda nimajo neposrednih ustreznikov, zato lahko pride do manjših razlik v oblikovanju.
Zakaj uporabljati format YAML?
YAML je priljubljen za konfiguracijske datoteke, ker je zelo berljiv z minimalno sintakso. Je standard za Docker Compose, Kubernetes, GitHub Actions in številna orodja CI/CD.
Ali pretvornik obravnava ugnezdene ali kompleksne strukture JSON?
ja Orodje pravilno razčleni ugnezdene predmete, nize in vse standardne vrste podatkov JSON, pri čemer ohrani celotno strukturo podatkov v izhodu YAML.
Je ta pretvorba varna in zasebna?
ja Vsa obdelava poteka lokalno v vašem brskalniku. Vaši podatki nikoli ne zapustijo vaše naprave – brez nalaganja na strežnik, brez obdelave v oblaku, brez zbiranja podatkov.
Kaj pa nizi s posebnimi znaki?
js-yaml jih samodejno navede. Nizi, ki vsebujejo dvopičja, zgoščene vrednosti ali začetne pomišljaje, so zaviti v narekovaje, da je YAML dobro oblikovan.
Ali so moji podatki naloženi na strežnik?
Ne. Pretvorba poteka v vašem brskalniku z uporabo js-yaml.
Ali lahko preusmerim JSON v YAML in nazaj?
ja JSON → YAML → JSON strukturno ohrani podatke. Vrstni red ključev pretvorjenega JSON se ujema z vnosom.
Kakšna je največja velikost vnosa?
Do 50 MB. js-yaml takoj obravnava tipične konfiguracijske datoteke.