Mesclagem profunda com mergeOverwrite e dict

Às vezes, você precisa montar um mapa dentro de um modelo. A função dict cria um a partir de pares alternados de chaves e valores.

Geralmente, você tem padrões do pacote e substituições do usuário e quer um único mapa combinado. É exatamente isso que uma função merge produz.

A função merge copia chaves dos mapas de origem para um destino, mas mantém o valor do destino sempre que uma chave já existe.

Com merge, o primeiro argumento vence quando há conflito entre chaves, por isso a função é ideal quando a entrada do usuário deve substituir os seus valores padrão.

A função mergeOverwrite faz o oposto: os mapas de origem posteriores substituem o destino, adicionando valores sobre ele.

Os dois auxiliares fazem a mesclagem recursivamente: os mapas aninhados são combinados chave por chave, em vez de toda a subárvore ser substituída de uma só vez.

Cuidado: merge e mergeOverwrite alteram o primeiro argumento diretamente. Passe um dict novo se precisar manter o original intacto.

Um padrão comum é começar com um dict de valores padrão e depois adicionar os valores do usuário por cima, para que as chaves não definidas usem um valor de reserva com segurança.

Depois de mesclar, você trata o resultado como qualquer mapa e obtém as chaves com dot ou com a função index, como de costume.

Para emitir uma estrutura mesclada como YAML, encaminhe-a por toYaml e nindent, para que o bloco fique com o recuo correto.

Quando o nome de uma chave é dinâmico ou contém caracteres incomuns, acesse o mapa com a função index em vez do acesso por ponto.

Verificação rápida sobre a direção da substituição.

Você conheceu dict para criar mapas, merge para manter as chaves do destino e mergeOverwrite para permitir que os valores posteriores prevaleçam, com todas as mesclagens ocorrendo em profundidade. 🎉