HiYaPyCo

HiYaPyCo - A Hierarchical Yaml Python Config

Description

A simple python lib allowing hierarchical overlay of config files in YAML syntax, offering different merge methods and variable interpolation based on jinja2.

Key Features

hierarchical overlay of multiple YAML files
multiple merge methods for hierarchical YAML files
variable interpolation using jinja2

Requirements

PyYAML aka. python-yaml
Jinja2 aka. python-jinja2

Python Version

HiYaPyCo was designed to run on both current major python versions without changes. Tested versions:

Usage

A simple example:

import hiyapyco
conf = hiyapyco.load('yamlfile1' [,'yamlfile2' [,'yamlfile3' [...]]] [,kwargs])
print(hiyapyco.dump(conf))

real life example:

yaml1.yaml:
---
first: first element
second: xxx
deep:
    k1:
        - 1
        - 2

yaml2.yaml:
---
second: again {{ first }}
deep:
    k1:
        - 4
        - 6
    k2:
        - 3
        - 6

load …

>>> import pprint
>>> import hiyapyco
>>> conf = hiyapyco.load('yaml1.yaml', 'yaml2.yaml', method=hiyapyco.METHOD_MERGE, interpolate=True, failonmissingfiles=True)
>>> pprint.PrettyPrinter(indent=4).pprint(conf)
{   'deep': {   'k1': [1, 2, 4, 6], 'k2': [3, 6]},
    'first': u'first element',
    'ma': {   'ones': u'12', 'sum': u'22'},
    'second': u'again first element'}

args

All args are handled as file names. They may be strings or list of strings.

kwargs

method: bit (one of the listed below):
- hiyapyco.METHOD_SIMPLE: replace values (except for lists a simple merge is performed) (default method)
- hiyapyco.METHOD_MERGE: perform a deep merge
interpolate: boolean : perform interpolation after the merge (default: False)
failonmissingfiles: boolean : fail if a supplied YAML file can not be found (default: True)
loglevel: int : loglevel for the hiyapyco logger; should be one of the valid levels from logging: ‘WARN’, ‘ERROR’, ‘DEBUG’, ‘I NFO’, ‘WARNING’, ‘CRITICAL’, ‘NOTSET’ (default: default of logging)
loglevelmissingfiles: int : one of the valid levels from logging: ‘WARN’, ‘ERROR’, ‘DEBUG’, ‘INFO’, ‘WARNING’, ‘CRITICAL’, ‘NOTSET’ (default: logging.ERROR if failonmissingfiles = True, else logging.WARN)

interpolation

The default jinja2.Environment for the interpolation is

hiyapyco.jinja2env = Environment(undefined=Undefined)

This means that undefined vars will be ignored and replaced with a empty string. If you like to change the jinja2 Environment used for the interpolation, set hiyapyco.jinja2env before calling hiyapyco.load!

If you like to keep the undefined var as string but raise no error, use

from jinja2 import Environment, Undefined, DebugUndefined, StrictUndefined
hiyapyco.jinja2env = Environment(undefined=DebugUndefined)

If you like to raise a error on undefined vars, use

from jinja2 import Environment, Undefined, DebugUndefined, StrictUndefined
hiyapyco.jinja2env = Environment(undefined=StrictUndefined)

See: jinja2.Environment

Install

From Source

GitHub

git clone https://github.com/zerwes/hiyapyco
cd hiyapyco
sudo python setup.py install

PyPi

Download the latest or desired version of the source package from https://pypi.python.org/pypi/HiYaPyCo. Unpack the archive and install by executing:

sudo python setup.py install

pip

Install the latest wheel package using:

pip install HiYaPyCo

debian packages

echo "deb http://repo.zero-sys.net/hiyapyco/deb ./" > /etc/apt/sources.list.d/hiyapyco.list
gpg --recv-key ED7D414C
gpg --armor --export ED7D414C | apt-key add -
apt-get update
apt-get install python3-hiyapyco python-hiyapyco

rpm packages

use http://repo.zero-sys.net/hiyapyco/rpm as URL for the yum repo and http://jwhoisserver.net/key.asc as the URL for the key.

License

2014 Klaus Zerwes zero-sys.net This package is free software. This software is licensed under the terms of the GNU LESSER GENERAL PUBLIC LICENSE version 3 or later, as published by the Free Software Foundation. See https://www.gnu.org/licenses/lgpl.html

Metadata

Release files for HiYaPyCo 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for HiYaPyCo 0.2.0
File	Size	Uploaded
HiYaPyCo-0.2.0.tar.gz	12.4 kB	Nov 20, 2014	Details

Built distribution (wheel)

Table of built distributions (wheels) for HiYaPyCo 0.2.0
File	Interpreter	ABI	Platform	Reset
HiYaPyCo-0.2.0-py2.py3-none-any.whl 9.3 kB Nov 20, 2014	Python 2, Python 3	none	any	Details

Total release size: 21.7 kB

Release files / HiYaPyCo-0.2.0.tar.gz

Download URL	HiYaPyCo-0.2.0.tar.gz
Size	12.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`66f5afede29d65941972cbdd77973a70e9ea2f1b84fcb169dd647f94d1b30999`
BLAKE2b-256 checksum How to use checksums	`a21cde04a28ddd05a44d3e6be0f6d70efe0765e38bd63657f4a36e6f544bf464`
Upload date	Nov 20, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / HiYaPyCo-0.2.0-py2.py3-none-any.whl

Download URL	HiYaPyCo-0.2.0-py2.py3-none-any.whl
Size	9.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`b8d99d259d858d095c12ead261a5dd88fb256bb0841acc088dc64eedca3471f4`
BLAKE2b-256 checksum How to use checksums	`869c1b6c58af5c04e1f5f9ce5ec6444ff47cab094ad3c449f2e441fd1bffebdb`
Upload date	Nov 20, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No