// converters
YAML Flattener.
Flatten a nested YAML structure into dotted keys, or unflatten a flat dotted-key map back into nested form.
Input
Output
Domande frequenti
Cos'è la notazione puntata?
Trasforma {a: {b: 1}} in a.b = 1.
Posso invertire l'appiattimento?
Sì, lo strumento può ricostruire la struttura annidata.
Funziona con gli array?
Sì, gli array vengono estesi con indici array.0, array.1.
Cos’è l’appiattimento YAML
L’appiattimento YAML converte una struttura annidata in una serie di coppie chiave-valore piatte, dove ogni chiave rappresenta il percorso completo nella gerarchia originale. Ad esempio, {a: {b: 1}} diventa {`a.b': 1}.',
Questa trasformazione è utile quando è necessario accedere a valori nidificati in sistemi che non supportano la struttura YAML originale, come variabili d’ambiente o sistemi di key-value piatti.
Il risultato mantiene tutta l’informazione del file originale in un formato più semplice e uniforme, facilitando l’elaborazione programmatica.
Quando appiattire il YAML
L’appiattimento è particolarmente utile quando si importano configurazioni YAML in sistemi che supportano solo chiavi piatte, come le variabili d’ambiente Docker o le configurazioni di CI/CD.
In contesti dove è necessario cercare o filtrare per chiavi specifiche senza navigare la struttura ad albero, un formato piatto è molto più efficiente.
Anche per il debugging e l’analisi dei dati, un formato piatto rende più facile l’ispezione visiva di tutti i valori presenti nel file YAML originale.
Come funziona la conversione
La conversione usa un separatore (tipicamente il punto) per concatenare le chiavi dei livelli annidati. Ogni livello di profondità viene aggiunto alla chiave padre, creando un percorso completo.
Gli array possono essere gestiti in diversi modi: con indici numerici (items.0, items.1) o con chiavi generate automaticamente. Lo strumento preserva tutti i valori originali.
L’appiattimento è irreversibile in senso stretto, poiché la struttura originale può non essere completamente ricostruibile senza informazioni aggiuntive sul tipo di dati di ogni nodo.