1#

2# Copyright (C) 2019-2025 Mathieu Parent <math.parent@gmail.com>

3#

4# This program is free software: you can redistribute it and/or modify

5# it under the terms of the GNU Lesser General Public License as published by

6# the Free Software Foundation, either version 3 of the License, or

7# (at your option) any later version.

8#

9# This program is distributed in the hope that it will be useful,

10# but WITHOUT ANY WARRANTY; without even the implied warranty of

11# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

12# GNU Lesser General Public License for more details.

13#

14# You should have received a copy of the GNU Lesser General Public License

15# along with this program. If not, see <http://www.gnu.org/licenses/>.

16

17 from __future__ import annotations

18

19 from copy import deepcopy

20

21

22# Deeply update target with defaults where appropriate

23 def update_dict_with_defaults(target: dict, defaults: dict, *, aggregate: bool = False) -> None:

24 """Merge dictionnaries.

25

26 Args:

27 target: Target dictionnary.

28 defaults: Defaults dictionnary.

29 aggregate: If true, lists are aggregated.

30 """

31 for key, value in defaults.items():

32 if key in target:

33 if isinstance(target[key], dict):

34 update_dict_with_defaults(target[key], value, aggregate=aggregate)

35 elif isinstance(target[key], list) and aggregate:

36 target[key] = deepcopy(value) + deepcopy(target[key])

37 else:

38 target[key] = deepcopy(value)