rougail/README.md

2.3 KiB
Raw Blame History

Logo Rougail

Rougail

Description

Rougail is a free full-featured configuration manager library written in python3.

The configuration is describe in YAML dictionary files.

Those dictionaries are converted into Tiramisu objects.

Rougail can be incorporated with other technologies and stacks regardless of whether theyre written in Python or not.

Simple example

Create a directory:

# mkdir dict

Dictionary

A dictionary is a variables description file.

Create the file dict/dictionary.yml:

---
version: '1.0'
# describe a variable my_first_variable
# and a family with a variable my_second_variable
my_first_variable:
  default: my_value
my_family:
  my_second_variable:
    type: number
    mandatory: true
    value: 1

Generate variable

With default value:

Here is a python3 example file:

from rougail import Rougail, RougailConfig
from pprint import pprint

RougailConfig['dictionaries_dir'] = ['dict']
RougailConfig['templates_dir'] = ['tmpl']
RougailConfig['tmp_dir'] = 'tmp'
RougailConfig['destinations_dir'] = 'dest'
rougail = Rougail()
config = rougail.get_config()
pprint(config.value.get(), sort_dicts=False)

The result is:

{'rougail.my_first_variable': 'my_value',
 'rougail.my_family.my_second_variable': 1}

With modified value

Use Tiramisu API to change values:

from rougail import Rougail, RougailConfig
from pprint import pprint

RougailConfig['dictionaries_dir'] = ['dict']
RougailConfig['templates_dir'] = ['tmpl']
RougailConfig['tmp_dir'] = 'tmp'
RougailConfig['destinations_dir'] = 'dest'
rougail = Rougail()
config = rougail.get_config()
config.option('rougail.my_first_variable').value.set('modified_value')
config.option('rougail.my_family.my_second_variable').value.set(2)
pprint(config.value.get(), sort_dicts=False)

The destination file is generated with new values:

{'rougail.my_first_variable': 'modified_value',
 'rougail.my_family.my_second_variable': 2}

Link

Related projects