Formattatore e Validatore YAML

YAML utilizza l'indentazione (spazi) per definire la struttura del documento e la nidificazione — non ci sono parentesi graffe o tag di chiusura come in JSON o XML. Il livello di indentazione di un elemento determina se esso sia figlio dell'elemento superiore o un elemento fratello. Uno spazio in più o mancante può cambiare completamente il significato: una chiave che dovrebbe essere una sottoproperty di una definizione di servizio potrebbe invece diventare una chiave di alto livello, spesso senza alcun messaggio di errore da parte del parser YAML. Ecco perché gli errori YAML sono notoriamente difficili da debuggare — il sintomo (configurazione errata) può essere lontano dalla causa (uno spazio fuori posto alla riga 47).

No. La specifica YAML proibisce esplicitamente i caratteri tab per l'indentazione. I tab sono consentiti all'interno di stringhe tra virgolette, ma mai come indentazione. Se il tuo editor è impostato per inserire tab quando premi Tab, cambialo per inserire spazi per i file YAML. Molti bug relativi a YAML sono causati da tab invisibili in file che sembrano correttamente indentati. Questo formatter rileva e normalizza l'indentazione dei tab in spazi.

Il formatter gestisce l'intero set di funzionalità di YAML 1.2: tipi scalari (stringhe, interi, float, booleani, null), block mappings (key: value), block sequences (- item), flow style (inline {} e []), stringhe multiline (literal block | e folded block >), commenti (#), anchors (&anchor) e aliases (*alias), documenti multipli (separatore ---) e tag di tipo espliciti (!!str, !!int, ecc.). Strutture nidificate complesse come i pod di Kubernetes con volumi, array env e limiti di risorse vengono formattati correttamente.

I commenti vengono riconosciuti durante la validazione e il parsing. Durante la formattazione, lo strumento riserializza la struttura dei dati analizzati — poiché la maggior parte dei parser YAML non associa i commenti al modello di dati, i commenti potrebbero non essere completamente preservati nell'output formattato. Per scopi di validazione (controllo della correttezza), i commenti vengono gestiti correttamente. Se la conservazione esatta dei commenti è critica, copia la versione formattata nel tuo editor e riaggiungi manualmente i commenti.

Gli errori più frequenti: (1) Indentazione incoerente — mistura di indentazione a 2 spazi e 4 spazi, o tab misti con spazi. (2) Chiavi duplicate nello stesso mapping. (3) Stringhe non quotate che YAML interpreta come valori speciali — "yes", "no", "true", "false", "null", "on", "off" vengono tutti interpretati come booleani o null in YAML 1.1 (comune nelle vecchie configurazioni di Kubernetes). (4) Due punti senza spazi in chiavi non quotate. (5) Spazio mancante dopo i due punti nelle coppie chiave: valore. (6) Stringhe non quotate contenenti caratteri speciali YAML (: { } [ ] # &).

YAML è un superset di JSON — il JSON valido è anche un YAML valido. YAML aggiunge funzionalità amiche per l'uomo che a JSON mancano: commenti, stringhe multiline, anchors/aliases per riutilizzare valori e meno punteggiatura (niente virgole tra gli elementi dell'array, non servono virgolette per i semplici valori stringa). JSON ha vantaggi per i dati generati dalle macchine: non è sensibile all'indentazione, è supportato nativamente da ogni linguaggio ed è inequivocabile. Per i file di configurazione modificati a mano, YAML è generalmente preferito. Per le risposte API e l'archiviazione dei dati, JSON è la scelta dominante.

No. Tutti i processi di formattazione e validazione vengono eseguiti nel tuo browser utilizzando un parser YAML JavaScript. I tuoi file di configurazione, che potrebbero contenere variabili d'ambiente, credenziali e dettagli dell'infrastruttura, non lasciano mai il tuo dispositivo.