npconf 0.0.3

A flexible, intuitive native-python configuration system.

npconf is a flexible configuration system whose configuration files are plain python modules. The identifiers (left-hand side) are declared by the administrator/developer and are hierarchical. A typical configuration file might be:

myapp.subcomponent.value = 1
myapp.enabled = True

The user needn’t define “myapp”. It’s automatically included in globals().

The administrator/developer can disallow user-defined attributes. This is mostly intended to prevent typos in the configuration files. In other words, if myapp.foo is not defined before reading the configuration files, no file will be allowed to set myapp.foo.

The configuration attributes are normally declared by a program before it reads any configuration files. They can be declared at init time:

import npconf

root = npconf.ConfigValue(name='myapp', data={'enabled': 'false'})
# and/or updated after init:
root.update(data={'thing': None})

# to add another level to the hierarchy:

subcomponent = npconf.ConfigValue(
    name='subcomponent',
    data={
        'foo': 'banana',
})
root.update({'subcomponent': subcomponent})