No description
Find a file
2024-10-14 14:14:00 +02:00
docs feat: add relative path support 2024-10-14 14:14:00 +02:00
src/rougail feat: add relative path support 2024-10-14 14:14:00 +02:00
tests feat: add relative path support 2024-10-14 14:14:00 +02:00
.gitignore first cadoles' version 2019-11-24 20:25:09 +01:00
.readthedocs.yaml feat: documentation 2023-12-17 20:42:03 +01:00
CHANGELOG.md bump: version 1.0.1 → 1.0.2 2024-01-28 20:43:45 +01:00
LICENSE add license 2022-03-08 20:42:29 +01:00
logo.png update logo 2022-11-11 11:04:31 +01:00
logo.svg add schema 2022-11-11 15:52:39 +01:00
pyproject.toml bump: version 1.0.1 → 1.0.2 2024-01-28 20:43:45 +01:00
README.md feat: documentation 2023-12-17 20:42:03 +01:00
setup.py Add silique copyright 2022-11-02 23:00:42 +01:00

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