Muunna JSON:n ja YAML:n välillä

Tämä työkalu muuntaa YAML-asiakirjan JSONiksi ja päinvastoin säilyttäen tietorakenteen (objektit, taulukot, skalaarityypit). JSONin muuntaminen YAML:ksi tai YAML:n muuntaminen JSONiksi on yleinen kehitysvaihe: luomme OpenAPI YAML-tiedoston JSON-määrityksestä, muunnamme REST API:n lähdön YAML:ksi, jotta se tallennetaan määritysvarastoon, käännetään Kubernetes YAML-luettelo JSON-kieleksi ja välitetään se tiedostoon kubectl --clientalign

JSON ja YAML vastaavat samankaltaisiin tarpeisiin, mutta erilaisiin käyttötapauksiin. Seuraavassa taulukossa on yhteenveto tärkeimmistä teknisistä eroista, joista on hyötyä valittaessa näiden kahden välillä kontekstin mukaan.

JSON on välttämätön, kun ohjelma keskustelee toisen ohjelman kanssa. Sen tyypilliset käyttötapaukset:

• REST- ja GraphQL-rajapinnat: pyyntö- ja vastauskuormat.
• Tiedonvaihto mikropalveluiden ja viestijonojen välillä.
• Natiivi JavaScript-koodi: JSON.parse ja JSON.stringify ilman riippuvuuksia.
• Selaimen puolen tallennus: localStorage, sessionStorage, IndexedDB.
• AJAX- ja fetch-pyynnöt.
• Binaariset tai virtaussuuntautuneet variantit: BSON (MongoDB), JSON Lines (lokit, ML-datasetit), MessagePack.
• JS / TS -työkalujen konfigurointi: package.json, tsconfig.json, composer.json.

YAML on välttämätön, kun ihminen muokkaa tiedostoa säännöllisesti. Sen tyypilliset käyttötapaukset:

• Docker Compose (docker-compose.yml) ja pinoprofiilit.
• Kubernetes-manifestit (Deployment, Service, Ingress, Helm-kaaviot).
• Ansible-pelikirjat ja inventaariot.
• CI/CD-putket: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI / Swagger- ja AsyncAPI-määritykset.
• Annotoitu sovelluskonfiguraatio (Symfony, Spring Boot, Rails), jossa kommentit ovat hyödyllisiä.
• Usein käsin muokattavat tiedostot, joissa ytimekkyys ja luettavuus ovat jäsennysnopeutta tärkeämpiä.

YAML on sallivampi kuin JSON, mikä tekee siitä tehokkaan mutta salakavalan muodon. Yleisimmät sudenkuopat:

• Sisennys : määrittely kieltää sarkainten (tab) käytön, vain välilyönnit ovat sallittuja. Näiden sekoittaminen tai välilyöntien määrän muuttaminen samassa lohkossa rikkoo jäsennyksen.
• Skalaarien automaattinen pakotus : yes, no, on, off, true, false, null, None, ~ jäsennellään totuusarvoiksi (boolean) tai nulliksi. Esimerkkiansat: lainausmerkitön postinumero 01234 muuttuu kokonaisluvuksi 1234, ja maan nimi NO (Norja) muuttuu arvoksi false. Käytä aina lainausmerkkejä epäselvissä merkkijonoissa.
• Moniriviset merkkijonot : | (block literal) säilyttää rivinvaihdot sellaisinaan, kun taas > (folded) korvaa rivinvaihdot välilyönneillä. Chomping-indikaattorit - ja + säätelevät viimeisen rivinvaihdon käyttäytymistä.
• YAML 1.1 vs 1.2 : versio 1.1 (edelleen hyvin yleinen, esimerkiksi PyYAML:n oletusarvona) käsittelee arvoja yes/no/on/off totuusarvoina, minkä versio 1.2 poisti. Käyttäytyminen poikkeaa myös 8-kantaisissa luvuissa.
• Implisiittiset päivämäärät : 2024-01-15 ilman lainausmerkkejä on joidenkin jäsentimien mielestä päivämääräobjekti, ei merkkijono.

Sama dokumentti JSON- ja YAML-muodossa. Sovelluksen yksinkertainen konfiguraatio riippuvuuksineen ja ympäristöineen:

JSON-versio

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Vastaava YAML-versio

# Sovelluksen konfiguraatio
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

YAML-versio on noin 25 % lyhyempi merkkimäärältään, sallii kommentin alussa ja on luettavissa ominaisuusluettelona ilman syntaksikohinaa.

Vaiheet tietojen muuntamiseksi:

1. Liitä lähdedokumenttisi (JSON tai YAML) syötekenttään.
2. Valitse haluamasi muunnan suunta (JSON:sta YAML:iksi tai YAML:ista JSON:iksi).
3. Napsauta muunnospainiketta: muotoiltu tulos ilmestyy tulosalueelle.
4. Tarkista tulos ja käytä kopiointipainiketta kopioidaksesi tuloksen leikepöydälle.

Muunnos suoritetaan paikallisesti selaimessasi tai erillisen palvelinreitin kautta työkalusta riippuen: arkaluonteisia tietoja ei tallenneta.