[ [crates.io] ] [ [lib.rs] ] [ [docs.rs] ]
This library forms the backend to [chezmoimodifymanager]. You probably want that tool instead.
This library provides merging of a source INI file with a target INI file. The merging is asymmetric: The values of the source are preferred unless specific rules have been provided for those sections and/or keys. Formatting is preserved.
The use case of this is configuration management for user settings file where the program writes a mix of settings and state to the same file. This gets messy if we want to track the settings part in git using a tool like [chezmoi].
A typical example of this is KDE settings files. These contain (apart from settings) state like recently opened files and positions of windows and dialog boxes. Other programs (such as PrusaSlicer) also do the same thing.
This library can be used as a backend to implement a tool to smartly merge such INI files. Such a tool is already available: [chezmoimodifymanager].