Pretvoriti med JSON in YAML

To orodje pretvori dokument YAML v JSON in obratno, pri čemer ohrani strukturo podatkov (objekti, tabele, skalarni tipi). Pretvorba JSON v YAML ali YAML v JSON je pogosta operacija v razvoju: ustvarimo datoteko OpenAPI YAML iz specifikacije JSON, pretvorimo izhod API-ja REST v YAML, da ga prenesemo v repozitorij konfiguracije, prevedemo manifest Kubernetes YAML v JSON, da ga posredujemo kubectl --dry-run=client -o json, ali poravnamo Dejanja poteka dela GitHub s shemo JSON. V širšem smislu je most med svetom izmenjave podatkov (JSON) in svetom ročno urejane konfiguracije (YAML).

JSON in YAML obravnavata podobne potrebe, vendar različne primere uporabe. Naslednja tabela povzema glavne tehnične razlike, uporabne za izbiro med obema glede na kontekst.

JSON je potreben vedno, ko se program pogovarja z drugim programom. Njegovi tipični primeri uporabe:

• API-ji REST in GraphQL: obremenitve zahtev in odgovorov.
• Izmenjava podatkov med mikro storitvami in čakalnimi vrstami sporočil.
• Izvorna koda JavaScript: JSON.parse in JSON.stringify brez odvisnosti.
• Shramba na strani brskalnika: localStorage, sessionStorage, IndexedDB.
• Zahteve AJAX in fetch.
• Binarne ali pretočno usmerjene različice: BSON (MongoDB), JSON Lines (dnevniki, nabori podatkov ML), MessagePack.
• Konfiguracija orodij JS/TS: package.json, tsconfig.json, composer.json.

YAML je potreben takoj, ko oseba redno ureja datoteko. Njegovi tipični primeri uporabe:

• Docker Compose (docker-compose.yml) in profili zlaganja.
• Manifesti Kubernetes (razmestitev, storitev, vhod, diagrami Helm).
• Ansible Playbooks in popisi.
• Cevi CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Specifikacije OpenAPI/Swagger in AsyncAPI.
• Konfiguracija aplikacije z opombami (Symfony, Spring Boot, Rails), kjer so komentarji uporabni.
• Datoteke, ki se pogosto urejajo ročno, kjer imata jedrnatost in berljivost prednost pred hitrostjo razčlenjevanja.

YAML je bolj permisiven kot JSON, zaradi česar je močan, a zahrbten format. Najpogostejše pasti:

• Zamik: specifikacija prepoveduje zavihke, veljavni so le presledki. Mešanje obeh ali spreminjanje števila presledkov v istem bloku prekine razčlenjevanje.
• Samodejno skalarno prisiljevanje: da, ne, on, off, true, false, null, None, ~ so razčlenjeni kot logične ali ničelne vrednosti. Primer pasti: poštna številka 01234 brez narekovajev postane celo število 1234 in ime države NO (Norveška) postane false. Dvoumne nize vedno postavite v narekovaje.
• Večvrstični nizi: | (blokovni literal) ohrani prelome vrstic takšne, kot so, medtem ko > (prepognjen) zamenja prelome vrstic s presledki. Zastavici žvečenja - in + prilagodita vedenje pri zadnjem skoku.
• YAML 1.1 proti 1.2: 1.1 (še vedno zelo pogost, na primer prek PyYAML privzeto) obravnava yes/no/on/off kot logične vrednosti, ki jih je 1.2 odstranil. Vedenja se razlikujejo tudi glede na številke z bazo 8.
• Implicitni datumi: 2024-01-15 brez narekovajev nekateri razčlenjevalniki razlagajo kot datumski objekt in ne kot niz.

Isti dokument, izražen v JSON in nato v YAML. Preprosta konfiguracija aplikacije z njenimi odvisnostmi in okoljem:

Različica JSON

{
    "ime": "cdrn-aplikacija",
    "različica": "1.14.2",
    "okolje": "proizvodnja",
    "odvisnosti": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": napačno
}

Enakovredna različica YAML

# Konfiguracija aplikacije
ime: cdrn-app
različica: 1.14.2
okolje: proizvodnja
odvisnosti:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doktrina/orm: '^3.0'
lastnosti:
    - predpomnilnik
    - poštar
    - rep
debug: false

Različica YAML je približno 25 % krajša v znakih, sprejema vodilni komentar in se bere kot seznam lastnosti brez sintaktičnega šuma.

Koraki za pretvorbo podatkov:

1. Prilepite izvorni dokument (JSON ali YAML) v polje za vnos.
2. Izberite želeno smer pretvorbe (JSON v YAML ali YAML v JSON).
3. Kliknite gumb za pretvorbo: oblikovani rezultat se prikaže v izhodnem območju.
4. Preverite upodabljanje in nato uporabite gumb za kopiranje, da pridobite rezultat v odložišče.

Pretvorba se izvede lokalno v vašem brskalniku ali prek namenske strežniške poti, odvisno od orodja: občutljivi podatki se ne ohranijo.