Piera

Piera is a lightweight, pure-Python Hiera parser. It was built to help bridge the gap between Puppet/Hiera and Python system scripts. Piera is currently not feature complete, lacking some less-used interoplation and loading features (feel free to contribute!)

Why?

Piera was built at Braintree to help us bridge a gap of emerging Python system scripts, and a historical storage of Puppet/Hiera data.

Install It

PyPi

pip install piera

Manual

git clone git@github.com:b1naryth1ef/piera.git
cd piera
python setup.py install

Usage

import piera

h = piera.Hiera("my_hiera.yaml")

# You can use piera to simply interact with your structured Hiera data

# key: 'value'
assert h.get("key") == "value"

# key_alias: '%{alias('key')}'
assert h.get("key_alias") == "value"

# key_hiera: 'OHAI %{hiera('key_alias')}'
assert h.get("key_hiera") == "OHAI value"

# Give piera context
assert h.get("my_context_based_key", name='test01', environment='qa') == "context is great!"

# Get and assert in one call
print('\nContext:', h.context)
h.get_and_assert("key_hiera", 'OHAI value')

Get and assert will give the following output:

Context: {}
Getting: key_hiera, expecting: OHAI value

And it the assertion fails:

Failure: 'key_hiera' was: 'unexpected value', expected: 'OHIA value'

And the script will exit

Requirements

Python 2.7+
Python 3.x

Compatibility Notes

v1.3.0 : Version 5 Support

This version breaks backwards compatibility by simplifying the hiera constructor call for ClearBank.

# In v1.2.0:
h = piera.Hiera("my_hiera.yaml")

# In v1.3.0 would need to be:
h = piera.Hiera("my_hiera.yaml", version=3, always_resolve=True)

wurlinc/piera