Deep Merge dengan mergeOverwrite dan dict

Terkadang Anda perlu menyusun peta di dalam templat. Fungsi dict membuatnya dari pasangan kunci dan nilai yang berselang-seling.

Anda sering memiliki bawaan bagan dan penggantian dari pengguna, lalu menginginkan satu peta gabungan. Itulah tepatnya yang dihasilkan oleh merge.

Fungsi merge menyalin kunci dari peta sumber ke tujuan, tetapi mempertahankan nilai tujuan jika kunci tersebut sudah ada.

Dengan merge, argumen pertama menang jika ada kunci yang bertabrakan, sehingga fungsi ini ideal ketika masukan pengguna harus menggantikan nilai bawaan Anda.

Fungsi mergeOverwrite melakukan sebaliknya: peta sumber yang muncul belakangan menimpa tujuan dan melapisi nilai di atasnya.

Kedua pembantu tersebut melakukan penggabungan secara rekursif: peta bertingkat digabungkan berdasarkan setiap kunci, bukan seluruh subpohon yang diganti sekaligus.

Berhati-hatilah: merge dan mergeOverwrite mengubah argumen pertamanya secara langsung. Berikan dict baru jika Anda harus mempertahankan yang asli tetap utuh.

Pola yang umum adalah memulai dari dict bawaan, lalu melapiskan nilai pengguna di atasnya agar kunci yang tidak ditetapkan kembali ke nilai yang aman.

Setelah digabungkan, Anda memperlakukan hasilnya seperti peta apa pun dan mengambil kunci dengan dot atau fungsi index seperti biasa.

Untuk menghasilkan struktur gabungan sebagai YAML, teruskan melalui toYaml dan nindent agar blok tersebut berada pada indentasi yang tepat.

Jika nama kunci bersifat dinamis atau berisi karakter yang tidak biasa, akses peta dengan fungsi index, bukan akses menggunakan dot.

Anda telah mengenal dict untuk membuat peta, merge untuk mempertahankan kunci tujuan, dan mergeOverwrite agar nilai yang muncul belakangan menang; semuanya melakukan penggabungan secara mendalam. 🎉