Jinja2:Python中强大的模板引擎

Jinja2是一种基于Python的模板引擎,用于生成HTML或其他文本文件。它具有简洁的语法和强大的功能,使得模板的编写和维护变得简单而高效。

Jinja2的语法主要包括以下几个部分:
变量:
使用大括号{{ variable }}来定义变量,可以在模板中直接输出变量的值。
控制结构:
Jinja2支持条件语句、循环语句等控制结构,可以用来实现条件判断、列表遍历等操作。
过滤器:
使用管道符|来定义过滤器,可以对变量的值进行格式化、字符串处理等操作。
模板继承:
通过继承其他模板,可以在子模板中重用父模板的代码和布局。

安装方式

sudo easy_install Jinja2
sudo pip install Jinja2

变量
应用把变量传递到模板,你可能在模板中弄混。变量上面也可以有你能访问的属性或元 素。变量看起来是什么,完全取决于应用提供了什么。
你可以使用点( . )来访问变量的属性,作为替代,也可以使用所谓的“下标”语 法( [] )。下面的几行效果是一样的:

{{ foo.bar }}
{{ foo['bar'] }}

空白控制
默认配置中,模板引擎不会对空白做进一步修改,所以每个空白(空格、制表符、换行符 等等)都会原封不动返回。如果应用配置了 Jinja 的 trim_blocks ,模板标签后的 第一个换行符会被自动移除(像 PHP 中一样)。
此外,你也可以手动剥离模板中的空白。当你在块(比如一个 for 标签、一段注释或变 量表达式)的开始或结束放置一个减号( – ),可以移除块前或块后的空白:

{% for item in seq -%}
    {{ item }}
{%- endfor %}

赋值
在代码块中,你也可以为变量赋值。在顶层的(块、宏、循环之外)赋值是可导出的,即 可以从别的模板中导入。
赋值使用 set 标签,并且可以为多个变量赋值:

{% set navigation = [('index.html', 'Index'), ('about.html', 'About')] %}
{% set key, value = call_something() %}

包含
include 语句用于包含一个模板,并在当前命名空间中返回那个文件的内容渲 染结果:

{% include 'header.html' %}
    Body
{% include 'footer.html' %}

For

<h1>Members</h1>
<ul>
{% for user in users %}
  <li>{{ user.username|e }}</li>
{% endfor %}
</ul>

if

{% if users %}
<ul>
{% for user in users %}
    <li>{{ user.username|e }}</li>
{% endfor %}
</ul>
{% endif %}




Tips:
Jinja2去除不必要的空格
{{- … -}}:去除变量前后的空格
{%- … -%}:去除标签前后的空格

Jinja2常用内置过滤器

  • 转成字符串:| string
  • 转成整型:| int
  • 转成小写:| lower
  • 转成大写:| upper
  • 将’‘替换成 ‘-’:| replace(’', ‘-’)
  • 拼接字符串:| join(" ")
  • Jinja2格式化渲染,使用format

    {{- "hostname %s" | format(hostname) }}
    

    Jinja2模板渲染因循环或判断过多导致渲染慢的问题,可以减少模板中的逻辑,在python中处理数据
    我们可以自定义函数然后注入到jinja2里面功能模板使用

    def sortByIntfNameKey(res):
        return sorted(res, key=lambda x: float(ifNameToId(x[0]).replace('-', '.')))
    tmplDir = os.path.abspath(os.path.join(os.environ.get('CLISH_TARGET'), 'tmpl'))
                env = Environment(
                    loader=FileSystemLoader(tmplDir),
                    extensions=['jinja2.ext.do'],
                )
                env.trim_blocks = True
                env.lstrip_blocks = True
                #env.rstrip_blocks = True
                # 自定义过滤器
                env.filters['sortByIntfNameKey'] = sortByIntfNameKey
    

    举个例子:
    模板文件version.j2

    {% set version = res['text'] %}
    {% set version = cli_version %}
    {% set fversion = version['fversion'] %}
    {{- "F Version: %s\n" |  format(fversion) }}
    {{- "C Version      : %s" | format(version) }}
    
    def showversion(self):
            config = configparser.ConfigParser()
            config.read(CFG_PATH, encoding="utf-8")
            cli_version=config.get('VersionInfo','version')
            res = self.client.requests(url='/xxx/system/info')
            fversion = res['text']['release_version']
            result = self.render(template='version.j2',res=res, fversion =fversion ,cli_version=cli_version)
            print(result)
            return checkRes(res)
    

    http://docs.jinkan.org/docs/jinja2

    物联沃分享整理
    物联沃-IOTWORD物联网 » Jinja2:Python中强大的模板引擎

    发表回复