Djup sammanslagning med mergeOverwrite och dict

Ibland behöver Ni sätta samman en map i en mall. Funktionen dict skapar en från växelvisa nyckel- och värdepar.

Ofta har Ni standardvärden från chartet plus användaröverskrivningar och vill ha en enda kombinerad map. Det är precis vad en merge skapar.

Funktionen merge kopierar nycklar från källmappar till en destinationsmap, men behåller destinationsvärdet när en nyckel redan finns.

Med merge vinner det första argumentet vid nyckelkonflikter, så funktionen passar bra när användarindata ska åsidosätta era standardvärden.

Funktionen mergeOverwrite gör tvärtom: senare källmappar skriver över destinationen och lägger värden ovanpå.

Båda hjälpfunktionerna sammanfogar rekursivt: kapslade mappar kombineras nyckel för nyckel i stället för att hela delträdet ersätts på en gång.

Var försiktig: merge och mergeOverwrite ändrar sitt första argument på plats. Skicka en ny map om Ni måste behålla originalet oförändrat.

Ett vanligt mönster är att börja med en standardvärdesmap och sedan lägga användarvärden ovanpå, så att ej angivna nycklar säkert faller tillbaka till standardvärden.

När mappen har sammanfogats behandlar Ni resultatet som vilken map som helst och hämtar nycklar med dot eller indexfunktionen som vanligt.

Om Ni vill skriva ut en sammanfogad struktur som YAML skickar Ni den genom toYaml och nindent, så att blocket hamnar med rätt indrag.

När ett nyckelnamn är dynamiskt eller innehåller ovanliga tecken hämtar Ni det från mappen med funktionen index i stället för punktnotation.

Ni har lärt er använda dict för att skapa mappar, merge för att behålla destinationsnycklar och mergeOverwrite för att låta senare värden vinna, medan merge-funktionerna sammanfogar på djupet. 🎉