Unione profonda con mergeOverwrite e dict

A volte è necessario assemblare una mappa all'interno di un template. La funzione dict ne crea una a partire da coppie alternate di chiavi e valori.

Spesso si dispone dei valori predefiniti del chart e degli override dell'utente, e si desidera ottenere un'unica mappa combinata. È esattamente ciò che produce un merge.

La funzione merge copia le chiavi dalle mappe sorgente in una destinazione, ma conserva il valore della destinazione quando una chiave esiste già.

Con merge, il primo argomento prevale in caso di chiavi in conflitto, quindi è ideale quando l'input dell'utente deve sovrascrivere i valori predefiniti.

La funzione mergeOverwrite fa l'opposto: le mappe sorgente successive sovrascrivono la destinazione, sovrapponendo i valori.

Entrambi gli helper eseguono il merge in modo ricorsivo: le mappe annidate vengono combinate chiave per chiave, invece di sostituire interamente l'intero sottoalbero.

Attenzione: merge e mergeOverwrite modificano direttamente il primo argomento. Passi un dict nuovo se deve mantenere intatto l'originale.

Un pattern comune consiste nel partire da un dict di valori predefiniti e sovrapporre i valori dell'utente, così le chiavi non impostate usano un fallback sicuro.

Una volta eseguito il merge, tratti il risultato come una normale mappa e recuperi le chiavi con dot o con la funzione index, come di consueto.

Per emettere la struttura unita come YAML, la passi attraverso toYaml e nindent, così il blocco viene inserito al livello di indentazione corretto.

Quando il nome di una chiave è dinamico o contiene caratteri insoliti, acceda alla mappa con la funzione index invece dell'accesso tramite dot.

Verifica rapida sulla direzione di overwrite.

Ha visto dict per creare mappe, merge per mantenere le chiavi della destinazione e mergeOverwrite per dare la precedenza ai valori successivi, eseguendo sempre un merge profondo. 🎉