Convertirea între JSON și YAML

Acest instrument transformă un document YAML în JSON și invers, păstrând structura datelor (obiecte, tablouri, tipuri scalare). Conversia JSON spre YAML, sau YAML spre JSON, este o operație curentă în dezvoltare: se generează un fișier OpenAPI YAML dintr-o spec JSON, se convertește ieșirea unui API REST în YAML pentru a o commita într-un depozit de configurație, se traduce un manifest Kubernetes YAML în JSON pentru a-l trece la kubectl --dry-run=client -o json, sau se aliniază un workflow GitHub Actions cu o schemă JSON. Mai larg, este puntea între lumea schimbului de date (JSON) și cea a configurației editabile manual (YAML).

JSON și YAML adresează nevoi apropiate dar cazuri de utilizare diferite. Tabelul următor rezumă diferențele tehnice majore, utile pentru a alege între cele două în funcție de context.

JSON se impune imediat ce un program vorbește cu un alt program. Cazurile sale de utilizare tipice:

• API-uri REST și GraphQL: payload-uri de cerere și răspuns.
• Schimb de date între microservicii și cozi de mesaje.
• Cod JavaScript nativ: JSON.parse și JSON.stringify fără dependență.
• Stocare pe partea browserului: localStorage, sessionStorage, IndexedDB.
• Cereri AJAX și fetch.
• Variante binare sau orientate pe flux: BSON (MongoDB), JSON Lines (log-uri, dataset-uri ML), MessagePack.
• Configurare a instrumentelor JS / TS: package.json, tsconfig.json, composer.json.

YAML se impune imediat ce un om editează regulat fișierul. Cazurile sale de utilizare tipice:

• Docker Compose (docker-compose.yml) și profiluri de stack.
• Manifeste Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbook-uri Ansible și inventare.
• Pipeline-uri CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Specificații OpenAPI / Swagger și AsyncAPI.
• Configurație aplicativă adnotată (Symfony, Spring Boot, Rails) unde comentariile sunt utile.
• Fișiere editate frecvent manual, unde concizia și lizibilitatea primează asupra vitezei de parsing.

YAML este mai permisiv decât JSON, ceea ce face din el un format puternic dar trădător. Capcanele cele mai frecvente:

• Indentare: tab-urile sunt interzise de specificație, doar spațiile sunt valide. Amestecul celor două sau schimbarea numărului de spații în același bloc sparge parsing-ul.
• Coerciție automată a scalarilor: yes, no, on, off, true, false, null, None, ~ sunt parsate ca booleani sau null. Capcană exemplu: un cod poștal 01234 necitat devine întregul 1234, iar un nume de țară NO (Norvegia) devine false. Pune întotdeauna între ghilimele șirurile ambigue.
• Stringuri multilinie: | (block literal) păstrează salturile de linie ca atare, în timp ce > (folded) înlocuiește salturile de linie cu spații. Indicatorii de chomping - și + ajustează comportamentul pe saltul final.
• YAML 1.1 vs 1.2: 1.1 (încă foarte răspândit, de exemplu prin PyYAML implicit) tratează yes/no/on/off ca booleani, ceea ce 1.2 a suprimat. Comportamentele diferă și pe numerele în bază 8.
• Date implicite: 2024-01-15 fără ghilimele este interpretat ca obiect dată de anumiți parseri, nu ca șir.

Același document, exprimat în JSON apoi în YAML. Configurație simplă a unei aplicații cu dependențele și mediul său:

Versiune JSON

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

Versiune YAML echivalentă

# Configurația aplicației
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

Versiunea YAML este mai scurtă cu aproximativ 25% în caractere, acceptă un comentariu în capul listei și se citește ca o listă de proprietăți fără zgomot sintactic.

Pași pentru a converti datele tale:

1. Lipește documentul tău sursă (JSON sau YAML) în câmpul de intrare.
2. Selectează sensul de conversie dorit (JSON spre YAML, sau YAML spre JSON).
3. Apasă pe butonul de conversie: rezultatul formatat apare în zona de ieșire.
4. Verifică randarea, apoi utilizează butonul de copiere pentru a recupera rezultatul în clipboard-ul tău.

Conversia este efectuată local în browserul tău sau printr-o rută server dedicată în funcție de tooling: nicio dată sensibilă nu este păstrată.