aferranc / python-confmerge

:snake: Python configuration file merge utility

ConfMerge - Python3 configuration file merge utility

ConfMerge lets you merge multiple configuration files into one file. Currently supported file formats are INI, YAML and JSON.

Installation

To install ConfMerge directly from Github:

pip install git+https://github.com/aferranc/[email protected]

RPM build

To build RPM package:

python3 setup.py bdist_rpm --binary-only --requires python3-pyyaml

Usage

usage: confmerge [-d] [-f] [-h] [-m MODE] [-t FILE_TYPE] [--debug] [--version]
                 src [src ...] dest

Merge multiple configuration files into one file

positional arguments:
  src                   The source files
  dest                  The destination file

optional arguments:
  -d, --dry-run         Print the merged content on stdout instead of writing
                        it to the destination file
  -f, --force           Force overwriting of any existing destination file
  -h, --help            Show this help message and exit
  -m MODE, --mode MODE  File mode for newly created files
  -t FILE_TYPE, --type FILE_TYPE
                        Type of file can be one of 'ini', 'json' or 'yaml'. If
                        not specified the type will be guessed from the file
                        extension
  --debug               Print debug trace on error
  --version             Print the program version and exit

Examples

Merge multiple INI files and write result into res.ini

confmerge -f 1.ini 2.ini 3.ini res.ini

Merge different types of configuration files:

confmerge -f 1.yml 2.json 3.ini res.yml

Perform a dry run (don't write output file but print result on stdout):

confmerge --dry-run 1.yml 2.yml not-touched.yml