Mercurial > hgrepos > Python > libs > ConfigMix
diff docs/introduction.rst @ 742:220a9ec9ac72
- Docs the the new list merging strategies.
Also some more words about merging generally.
- One more test about the default of "replacing" lists.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Sun, 29 Oct 2023 17:29:16 +0100 |
| parents | 3686bad61391 |
| children |
line wrap: on
line diff
--- a/docs/introduction.rst Sun Oct 29 17:15:41 2023 +0100 +++ b/docs/introduction.rst Sun Oct 29 17:29:16 2023 +0100 @@ -195,6 +195,17 @@ ``.yml`` or ``.yaml`` for YAML configuration files +When loading two or more configuration files the configurations will be +merged: + +* later values overwrite earlier values +* :py:class:`dict`-like objects are merged `recursively` +* :py:class:`list` objects are by default completely replaced by later ones. + When using ``merge_lists="extend"`` then later list extend earlier lists, + when using ``merge_lists="prepend"`` then earlier lists extend later ones. + + This is done `non-recursively`. + .. _getting-values: