pylibconfig2 0.2.5

The config

Config represents a libconfig configuration. The string representation is itself readable as a config. Access works via attributes:

>>> import pylibconfig2 as cfg
>>> c = cfg.Config("my_setting = 5;")
>>> str(c)
'my_setting = 5;'
>>> c.my_setting
5

Or via lookup as in the original libconfig way (no exceptions are raised):

>>> c = Config('my = {nested = {sett = (0, {ng = "rocks!"})}}')
>>> c.lookup('my.nested.sett.[1].ng')
'rocks!'
>>> c.lookup('my.nested.foo', 'bar')
'bar'

Setting values should be done by path (but attribution is also possible):

>>> c = Config('')
>>> c.setup('foo', 1)
True
>>> c.setup('bar', '{hello = "world"}')
True
>>> c.lookup('bar.hello')
'world'
>>> c.setup('a.nonexisting.group', '"returns False!"')
False

These functions are given for further convenience:

keys() values() items() get(key, default) set(key, value)

An array

ConfArray represents a libconfig array. Access works via the [] operator:

>>> c = cfg.Config("my_array = [1, 2, 3];")
>>> c.my_array[1]
2

A list

ConfList represents a libconfig list. Access works via the [] operator:

>>> c = cfg.Config('my_list = (1.5, 2L, 0xee, "string");')
>>> c.my_list[1]
2L

A group

ConfGroup represents a libconfig group. Access works via attributes:

>>> c = cfg.Config("my_group = {my_setting = 5;};")
>>> c.my_group.my_setting
5

Again, these functions are given for convenience:

keys() values() items() get(key, default) set(key, value)