Глубокое объединение с mergeOverwrite и dict

Иногда в шаблоне нужно собрать словарь. Функция dict создаёт его из чередующихся пар ключей и значений.

Часто у Вас есть значения чарта по умолчанию и пользовательские переопределения, которые нужно объединить в один словарь. Именно это делает функция merge.

Функция merge копирует ключи из исходных словарей в целевой, но сохраняет значение в целевом словаре, если такой ключ уже существует.

При использовании merge первый аргумент имеет приоритет при конфликте ключей, поэтому эта функция подходит, когда пользовательские значения должны переопределять значения по умолчанию.

Функция mergeOverwrite действует наоборот: последующие исходные словари перезаписывают целевой, накладывая значения поверх него.

Обе вспомогательные функции выполняют объединение рекурсивно: вложенные словари объединяются ключ за ключом, а не заменяются целиком.

Будьте внимательны: merge и mergeOverwrite изменяют свой первый аргумент на месте. Если исходный словарь нужно сохранить неизменным, передайте новый dict.

Распространённый шаблон — начать со словаря значений по умолчанию, а затем наложить поверх него пользовательские значения, чтобы для незаданных ключей безопасно использовались значения по умолчанию.

После объединения с результатом можно работать как с любым словарём и извлекать ключи с помощью dot или функции index, как обычно.

Чтобы вывести объединённую структуру в формате YAML, передайте её через toYaml и nindent, чтобы блок получил правильный отступ.

Если имя ключа является динамическим или содержит необычные символы, обращайтесь к словарю с помощью функции index, а не через обращение с точкой.

Короткая проверка направления перезаписи.

Вы познакомились с dict для создания словарей, с merge для сохранения ключей целевого словаря и с mergeOverwrite, позволяющей последующим значениям иметь приоритет. Все эти функции выполняют глубокое объединение. 🎉