Konverzia medzi JSON a YAML

Tento nástroj transformuje YAML dokument na JSON a naopak, pri zachovaní dátovej štruktúry (objekty, polia, skalárne typy). Konverzia JSON na YAML alebo YAML na JSON je bežná operácia vo vývoji: generujeme OpenAPI YAML súbor z JSON spec, konvertujeme výstup REST API na YAML pre commitnutie do konfiguračného repozitára, prekladáme YAML Kubernetes manifest na JSON pre kubectl --dry-run=client -o json, alebo zarovnávame GitHub Actions workflow s JSON schémou. Vo všeobecnosti je to most medzi svetom výmeny dát (JSON) a ručne editovateľnej konfigurácie (YAML).

JSON a YAML adresujú podobné potreby, ale odlišné prípady použitia. Nasledujúca tabuľka sumarizuje hlavné technické rozdiely, užitočné pre výber medzi nimi podľa kontextu.

JSON sa vyžaduje, akonáhle program hovorí s iným programom. Jeho typické prípady použitia:

• REST a GraphQL API: request a response payloady.
• Výmena dát medzi mikroservismi a message queues.
• Natívny JavaScript kód: JSON.parse a JSON.stringify bez závislosti.
• Úložisko na strane prehliadača: localStorage, sessionStorage, IndexedDB.
• AJAX a fetch dotazy.
• Binárne alebo stream-orientované varianty: BSON (MongoDB), JSON Lines (logy, ML datasety), MessagePack.
• JS / TS toolingové konfigurácie: package.json, tsconfig.json, composer.json.

YAML sa vyžaduje, akonáhle človek pravidelne edituje súbor. Jeho typické prípady použitia:

• Docker Compose (docker-compose.yml) a stack profily.
• Kubernetes manifesty (Deployment, Service, Ingress, Helm charts).
• Ansible playbooks a inventáre.
• CI/CD pipelines: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI / Swagger a AsyncAPI špecifikácie.
• Anotovaná aplikačná konfigurácia (Symfony, Spring Boot, Rails), kde sú komentáre užitočné.
• Súbory často editované ručne, kde stručnosť a čitateľnosť prevažujú nad parsing rýchlosťou.

YAML je permisívnejší ako JSON, čo z neho robí mocný, ale zradný formát. Najčastejšie pasti:

• Odsadenie: tabulátory sú špecifikáciou zakázané, iba medzery sú validné. Miešanie oboch alebo zmena počtu medzier v rovnakom bloku porušuje parsing.
• Automatická koercia skalárov: yes, no, on, off, true, false, null, None, ~ sú parsované ako booleany alebo null. Pascová ukážka: PSČ 01234 neúvodzovkované sa stáva celým číslom 1234, a názov krajiny NO (Nórsko) sa stáva false. Vždy úvodzovkovať dvojzmyselné reťazce.
• Viacriadkové strings: | (block literal) zachováva zlomy riadkov tak, ako sú, kým > (folded) nahrádza zlomy riadkov medzerami. Chomping indikátory - a + upravujú správanie na finálnom zlome.
• YAML 1.1 vs 1.2: 1.1 (stále veľmi rozšírená, napríklad cez PyYAML defaultne) spracováva yes/no/on/off ako booleany, čo 1.2 odstránila. Správanie sa líši aj na číslach v base 8.
• Implicitné dátumy: 2024-01-15 bez úvodzoviek je niektorými parsermi interpretované ako date objekt, nie ako reťazec.

Rovnaký dokument vyjadrený v JSON a potom v YAML. Jednoduchá konfigurácia aplikácie s jej závislosťami a prostredím:

JSON verzia

{
    "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
}

Ekvivalentná YAML verzia

# Konfiguracia aplikacie
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 verzia je o približne 25 % kratšia v znakoch, akceptuje komentár v hlavičke a číta sa ako zoznam vlastností bez syntaktického šumu.

Kroky pre konverziu vašich dát:

1. Vložte váš zdrojový dokument (JSON alebo YAML) do vstupného poľa.
2. Vyberte požadovaný smer konverzie (JSON na YAML, alebo YAML na JSON).
3. Kliknite na tlačidlo konverzie: formátovaný výsledok sa objaví vo výstupnej zóne.
4. Overte render, potom použite tlačidlo kopírovania pre získanie výsledku do schránky.

Konverzia sa vykonáva lokálne vo vašom prehliadači alebo cez dedikovanú serverovú rutu podľa toolingu: žiadne citlivé dáta nie sú uchovávané.