Simple to learn but yet powerful language for templating your configuration files.

• Simple to learn - a person familiar with the Python syntax basics could dive into conftl for 15 min.

• Powerful - Python code in templating.

• Command line tool for rendering.

• Python API for rendering

• Suitable for system administration, devops and similar roles.

• Performance - minimal code base optimized for performance.

• Platform independent - tested under Linux and Windows, should work on other Unix platforms as well, Python 2.7 compatible, Python 3.x compatible.

Install conftl using pip:

$ pip install conftl

Hello world from the command line:

$ render -c "name='John Smith'"
Hello, {{=name}}
Hello, John Smith

NOTE: Unix: Write Hello, {{=name}} on stdin, followed by Enter, Ctr+D

NOTE: Windows: Write Hello, {{=name}} on stdin, followed by Enter, Ctr+Z, Enter

Hello world from the Python REPL:

>>>
>>> from conftl import render
>>>
>>> render(content='Hello, {{=name}}', context=dict(name='John Smith'))
'Hello, John Smith'
>>>

Linux or other Unix distribution or Windows.

Python 2.7 or Python 3.x

Please place an issue in case the current implementation is not working with your platform and I will help.

Python Modules: future

As conftl embeds Python in the template, a prerequisite is one to have knowledge about the basic Python syntax.

Knowing basic Python syntax one must remember only the following three rules:

Rule 1) Python code should be enclosed in tags {{...}}

TEMPLATE                    | WILL OUTPUT
------------------------------------------
{{                          |
import sys                  |
def one():                  |
    return 1                |
i = 3                       |
}}                          |
------------------------------------------

NOTE: this Python code does not output anything, just imports, defines function, assigns variable.

Rule 2) Python blocks must end with the keyword {{pass}}

TEMPLATE                    | WILL OUTPUT
------------------------------------------
{{for i in range(0, 3):}}   | Hi, there!
Hi, there!                  | Hi, there!
{{pass}}                    | Hi, there!
------------------------------------------

Rule 3) Variables are printed to output enclosed in tags and prepended with = like {{=i}}

TEMPLATE                    | WILL OUTPUT
------------------------------------------
{{for i in range(0, 3):}}   | Listen 8080
Listen 808{=i}              | Listen 8081
{{pass}}                    | Listen 8082
------------------------------------------

For advanced syntax description see TEMPLATE_SYNTAX.md

Coming from Jinja? See JINJA.md

Coming from Web2py? See WEB2PY.md

Take a look at the examples folder for catching conftl in action.

conftl comes with a command line tool for quick and easy templating. It works like this:

$ render -i templatename.tmpl - o filename.conf

-i input template
-o output configuration file

Full description could be found in COMMAND_LINE.md

There are three interfaces for rendering a template from Python: the function render(...), the class Render and the decorator @template(...) .

The API description could be found here: PYTHON_API.md

• Arbitrary Python code is possible to be executed by the current templating language. I would advice against giving opportunity to the end-users to write template code, unless you know what you are doing. Multiple attack vectors could be used by a malicious end-user who has the possibility to execute arbitrary Python code. See security_considerations.txt

• In case you want to template some HTML output, you would be better off using other templating languages:

  • web2py's templating language called yatl

  • Jinja

The templating languages above have HTML escaping switched on by default, helper functions and other features suitable for web services.

Testing implementation on different platforms.

Place issue if you spot issues with this code.

Do not hesitate to fork me on github.

See HISTORY.txt

Also see the tags on the conftl repositiory.

The current project uses Semantic Versioning

Todor Todorov - ttt-fifo

This is open source software, free for personal and commercial use, licensed under:

BSD + other copyright credits

See LICENSE for details.

Thanks to Massimo Di Pierro and the web2py team for the inspiration.

Logo: server, icons, arrow

web2py on github

web2py templating language yatl

Another implementation of the same templating language may be found at the weppy project.

jinja on github