conf-templater 0.2.0b1

Templater for app configuration files.

Config files templater

Package provides templating of mako-based templates of package config files.

Purpose

The main idea is, that config can be generated via console arguments of it`s required values. It is useful for deploy with configuration systems like ansible and others.

There is no more reason to keep config template itself separately from application (in deploy scripts/roles/whatever) or to define example with comments what config values require changing.

Besides that, package or program, as usual, is situated in system package directory (with config templates), that looks like one more problem during configuring.

Installation (standalone usage)

sudo -H pip install git+https://bitbucket.org/p-app/config_templater

Usage (standalone)

conf_templater --help

Usage (python package)

• Add git+https://bitbucket.org/p-app/config_templater to requirements.txt.

• Create cli script file, for example mypackage/scripts/config.py, that contains:

from conf_templater import run_config_templating


def run():
    run_config_templating(package='mypackage', subpath='config')


if __name__ == '__main__':
    run()

• Create config file in package structure, for example mypackage/config/development.mako

• Define entry point in setup.py file:

from setuptools import setup

setup(
    name='mypackage',
    install_requires=[
        'conf_templater'
    ],
    entry_points={
        'console_scripts': [
            'mypackage_config = mypackage.scripts.config:run'
        ]
    }
)

• Run for development

pip install -e .

• Run for help

mypackage_config --help

Compatibility

This package is python 2 and 3 both compatible.