Tiefes Zusammenführen mit mergeOverwrite und dict

Manchmal müssen Sie innerhalb eines Templates eine Map zusammensetzen. Die Funktion dict erstellt eine Map aus abwechselnden Schlüssel-Wert-Paaren.

Oft haben Sie Standardwerte des Charts und Überschreibungen durch Nutzer und möchten daraus eine einzige kombinierte Map erstellen. Genau das erzeugt ein merge.

Die Funktion merge kopiert Schlüssel aus Quell-Maps in ein Ziel, behält jedoch immer den Zielwert bei, wenn ein Schlüssel bereits vorhanden ist.

Bei merge gewinnt das erste Argument bei jedem widersprüchlichen Schlüssel. Daher eignet sich die Funktion besonders, wenn Benutzereingaben Ihre Standardwerte überschreiben sollen.

Die Funktion mergeOverwrite macht das Gegenteil: Spätere Quell-Maps überschreiben das Ziel und legen ihre Werte darüber.

Beide Hilfsfunktionen führen rekursive Merges durch: Verschachtelte Maps werden Schlüssel für Schlüssel kombiniert, anstatt dass der gesamte Teilbaum vollständig ersetzt wird.

Vorsicht: merge und mergeOverwrite verändern ihr erstes Argument direkt. Übergeben Sie ein neues dict, wenn das Original unverändert bleiben muss.

Ein gängiges Muster besteht darin, mit einer Standardwerte-Map zu beginnen und anschließend Benutzerwerte darüberzulegen, sodass nicht gesetzte Schlüssel sicher auf die Standardwerte zurückfallen.

Nach dem Zusammenführen behandeln Sie das Ergebnis wie jede andere Map und lesen Schlüssel wie gewohnt mit dot oder der index-Funktion aus.

Um eine zusammengeführte Struktur als YAML auszugeben, leiten Sie sie durch toYaml und nindent, damit der Block korrekt eingerückt wird.

Wenn ein Schlüsselname dynamisch ist oder ungewöhnliche Zeichen enthält, greifen Sie mit der Funktion index auf die Map zu, statt den Punktzugriff zu verwenden.

Kurztest zur Überschreibungsrichtung.

Sie haben dict zum Erstellen von Maps kennengelernt, merge zum Beibehalten von Zielschlüsseln und mergeOverwrite, damit spätere Werte gewinnen – allesamt mit tiefen Merges. 🎉