Convertire tra JSON e YAML

Questo strumento trasforma un documento YAML in JSON e viceversa, preservando la struttura dei dati (oggetti, array, tipi scalari). La conversione JSON verso YAML, o YAML verso JSON, è un'operazione comune in sviluppo: si genera un file OpenAPI YAML a partire da una spec JSON, si converte l'output di un'API REST in YAML per committarla in un repository di configurazione, si traduce un manifest Kubernetes YAML in JSON per passarlo a kubectl --dry-run=client -o json, o si allinea un workflow GitHub Actions con uno schema JSON. Più ampiamente, è il ponte tra il mondo dello scambio di dati (JSON) e quello della configurazione modificabile a mano (YAML).

JSON e YAML rispondono a esigenze simili ma a casi d'uso diversi. La tabella seguente riassume le differenze tecniche principali, utili per scegliere tra i due a seconda del contesto.

JSON si impone non appena un programma parla a un altro programma. I suoi casi d'uso tipici:

• API REST e GraphQL: payload di richiesta e risposta.
• Scambio di dati tra microservizi e code di messaggi.
• Codice JavaScript nativo: JSON.parse e JSON.stringify senza dipendenze.
• Storage lato browser: localStorage, sessionStorage, IndexedDB.
• Richieste AJAX e fetch.
• Varianti binarie o orientate al flusso: BSON (MongoDB), JSON Lines (log, dataset ML), MessagePack.
• Configurazione di strumenti JS / TS: package.json, tsconfig.json, composer.json.

YAML si impone non appena un umano modifica regolarmente il file. I suoi casi d'uso tipici:

• Docker Compose (docker-compose.yml) e profili di stack.
• Manifest Kubernetes (Deployment, Service, Ingress, Helm chart).
• Playbook Ansible e inventari.
• Pipeline CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Specifiche OpenAPI / Swagger e AsyncAPI.
• Configurazione applicativa annotata (Symfony, Spring Boot, Rails) dove i commenti sono utili.
• File modificati frequentemente a mano, dove concisione e leggibilità contano più della velocità di parsing.

YAML è più permissivo di JSON, il che ne fa un formato potente ma infido. Le trappole più frequenti:

• Indentazione: le tabulazioni sono vietate dalla specifica, solo gli spazi sono validi. Mescolare i due o cambiare il numero di spazi in uno stesso blocco rompe il parsing.
• Coercizione automatica degli scalari: yes, no, on, off, true, false, null, None, ~ sono parsati in booleani o null. Esempio trappola: un codice postale 01234 non quotato diventa l'intero 1234, e un nome di paese NO (Norvegia) diventa false. Mettere sempre tra virgolette le stringhe ambigue.
• Stringhe multiriga: | (block literal) conserva i ritorni a capo così come sono, mentre > (folded) sostituisce i ritorni a capo con spazi. Gli indicatori di chomping - e + regolano il comportamento sul salto finale.
• YAML 1.1 vs 1.2: la 1.1 (ancora molto diffusa, per esempio tramite PyYAML per default) tratta yes/no/on/off come booleani, cosa che la 1.2 ha rimosso. I comportamenti differiscono anche sui numeri in base 8.
• Date implicite: 2024-01-15 senza virgolette è interpretato come un oggetto data da alcuni parser, non come una stringa.

Lo stesso documento, espresso in JSON poi in YAML. Configurazione semplice di un'applicazione con le sue dipendenze e il suo ambiente:

Versione 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
}

Versione YAML equivalente

# Configuration de l'application
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

La versione YAML è più corta di circa il 25% in caratteri, accetta un commento in testa e si legge come un elenco di proprietà senza rumore sintattico.

Passaggi per convertire i vostri dati:

1. Incollate il vostro documento sorgente (JSON o YAML) nel campo di input.
2. Selezionate il senso di conversione desiderato (JSON verso YAML, o YAML verso JSON).
3. Cliccate sul pulsante di conversione: il risultato formattato appare nella zona di output.
4. Verificate la resa, poi usate il pulsante di copia per recuperare il risultato negli appunti.

La conversione viene effettuata localmente nel browser o tramite una rotta server dedicata a seconda del tooling: nessun dato sensibile viene conservato.