A simple template-engine built for extremely simple usecases.
Supports:
- HTML block insertion
- Expressions (conditionals and variables)
- Template inheritance (extension) using base templates
- Recursive inheritance support (one parent / extension per template doc)
Syntax is similar to many of the popular template-engines.
{{ ... }} - Expressions, extending and variables
{% ... %} - Block statements such as if / else
Expression logic is safely evaluated using a subset of Python's mathematical and comparative operators. The following set of operations are supported:
- Mathmatical operators :
add,sub,div,mul,mod,pow - Comparison operators :
==, !=, <, >, <=, >= - Names : variable and starred variables
Variables are provided by passing a template_vars object containing variables
expected and used in template scope.
<html>
<body>
<div>
This is a var: {{ expr_variable }}
</div>
</body>
<html><html>
<body>
{% if str_var == 'variable' or 1 <= x < 10 %}
<div>Truthy conditional</div>
{% else %}
<div>Falsey conditional</div>
{% endblock %}
</body>
<html><!-- parent template -->
<html>
<head>
{% insert head %}{% endblock %}
</head>
<body>
{% insert child %}{% endblock %}
</body>
<html>
<!-- child template -->
{{ extends base.html }}
{% insert head %}
<style>
p {
color: red;
}
</style
{% endblock %}
{% insert child %}
<div>
This is a child
</div>
{% endblock %}Simply run temple.build command from the directory you want to compile.
temple can be installed as a local package pip install -e . from the root
directory of the project or the function can be imported directly with iPython
if needed.
from temple import build
build('**/*.html', output_path='/var/www/html/cv')Package must be installed locally to run unit-tests pip install -e . from project root dir.