Převést mezi JSON a YAML

Tento nástroj transformuje YAML dokument na JSON a obráceně, se zachováním datové struktury (objekty, pole, skalární typy). Konverze JSON na YAML, nebo YAML na JSON, je běžná operace ve vývoji: generuje se OpenAPI YAML soubor z JSON spec, převádí se výstup REST API na YAML pro commitnutí v konfiguračním repozitáři, překládá se Kubernetes YAML manifest na JSON pro kubectl --dry-run=client -o json, nebo se zarovnává GitHub Actions workflow s JSON schématem. Šířeji je to most mezi světem výměny dat (JSON) a ručně editovatelnou konfigurací (YAML).

JSON a YAML adresují blízké potřeby ale různé případy použití. Následující tabulka shrnuje hlavní technické rozdíly, užitečné pro volbu mezi nimi podle kontextu.

JSON se prosazuje, jakmile program mluví s jiným programem. Jeho typické případy použití:

• REST a GraphQL API: payload požadavku a odpovědi.
• Výměna dat mezi mikroslužbami a frontami zpráv.
• Nativní JavaScript kód: JSON.parse a JSON.stringify bez závislosti.
• Úložiště na straně prohlížeče: localStorage, sessionStorage, IndexedDB.
• AJAX a fetch požadavky.
• Binární nebo stream varianty: BSON (MongoDB), JSON Lines (logy, ML datasety), MessagePack.
• Konfigurace JS / TS nástrojů: package.json, tsconfig.json, composer.json.

YAML se prosazuje, jakmile člověk pravidelně edituje soubor. Jeho typické případy použití:

• Docker Compose (docker-compose.yml) a stack profily.
• Kubernetes manifesty (Deployment, Service, Ingress, Helm charts).
• Ansible playbooky a inventáře.
• CI/CD pipeliny: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• OpenAPI / Swagger a AsyncAPI specifikace.
• Anotovaná aplikační konfigurace (Symfony, Spring Boot, Rails), kde jsou komentáře užitečné.
• Soubory editované často ručně, kde stručnost a čitelnost převažují nad parsing rychlostí.

YAML je permisivnější než JSON, což z něj činí mocný ale zrádný formát. Nejčastější pasti:

• Indentace: tabulátory jsou specifikací zakázány, pouze mezery jsou validní. Mixování obou nebo měnění počtu mezer ve stejném bloku rozbíjí parsing.
• Automatický scalars coercion: yes, no, on, off, true, false, null, None, ~ jsou parsovány na booleany nebo null. Past příklad: poštovní směrovací číslo 01234 nekvotované se stává celým 1234, a název země NO (Norsko) se stává false. Vždy dejte do uvozovek nejednoznačné řetězce.
• Víceřádkové strings: | (block literal) zachovává zalomení řádků jak jsou, zatímco > (folded) nahrazuje zalomení řádků mezerami. Chomping indikátory - a + upravují chování na finálním zalomení.
• YAML 1.1 vs 1.2: 1.1 (stále velmi rozšířený, například přes PyYAML default) ošetřuje yes/no/on/off jako booleany, což 1.2 odstranil. Chování se také liší u čísel v základu 8.
• Implicitní data: 2024-01-15 bez uvozovek je interpretováno jako datový objekt některými parsery, ne jako řetězec.

Stejný dokument, vyjádřený v JSON pak v YAML. Jednoduchá konfigurace aplikace s jejími dependencies a prostředím:

JSON verze

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

# Konfigurace aplikace
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 verze je o asi 25 % kratší ve znacích, přijímá komentář v hlavičce a čte se jako seznam vlastností bez syntaktického šumu.

Kroky k převodu vašich dat:

1. Vložte svůj zdrojový dokument (JSON nebo YAML) do vstupního pole.
2. Vyberte požadovaný směr převodu (JSON na YAML, nebo YAML na JSON).
3. Klikněte na převodní tlačítko: formátovaný výsledek se objeví v oblasti výstupu.
4. Ověřte rendering, pak použijte kopírovací tlačítko pro získání výsledku do schránky.

Převod se provádí lokálně ve vašem prohlížeči nebo přes dedikovanou serverovou cestu podle toolingu: žádná citlivá data nejsou uchována.