jinja2是python中的一个优秀的模板语言，类似于django的模板。它的速度快，安全，目前被各种框架被广泛使用。 官网地址：http://jinja.pocoo.org/， 它的一些特性如下：
- 沙箱执行机制很安全
- 通过对HTML进行自动转义防止XSS攻击
- 模板继承
- 实时编译为最优化的python代码，使得它运行速度非常快
- 可选的模板预编译
- 容易调试，错误行数直接指向模板中的行
- 配置文件语法也是模板
安装非常简单，一条命令搞定：
In [2]:
pip install jinja2
Requirement already satisfied: jinja2 in /opt/conda/lib/python3.12/site-packages (3.1.5) Requirement already satisfied: MarkupSafe>=2.0 in /opt/conda/lib/python3.12/site-packages (from jinja2) (3.0.2) Note: you may need to restart the kernel to use updated packages.
In [3]:
from jinja2 import Template
template = Template('Hello {{ name }}!')
template.render(name='John Doe')
Out[3]:
'Hello John Doe!'
Python3的支持： 目前是支持Python3.3或以上版本的，所有单元测试都能通过，但是可能还会有隐藏的小bug。
In [4]:
from jinja2 import Environment, PackageLoader
env = Environment(loader=PackageLoader('tutoapp', 'templates'))
它会创建一个Environment，使用了默认配置和一个在yourapp包的templates文件夹下面搜索模板的加载器。 还可以使用其他的加载器，或者自定义加载器，来从数据库或其他地方加载模板。
要想加载到一个模板，只需使用 get_template() 方法。
In [5]:
uu = env.list_templates()
In [6]:
template = env.get_template('mytpml.jinja2')
template.render(the='variables', go='here')
Out[6]:
'<body>\n \n</body>'
Unicode Jinja2内部使用Unicode，所以传给render方法的参数必须是unicode对象，
另外换行符是unix的’\n’。
Jinja2的模板默认编码是utf-8，一些库会严格检查str类型比如datetime.strftime，
它不接受unicode参数。 所以Jinja2对于ascii字符串返回str，其他的返回unicode，比如：
In [7]:
m = Template(u"{% set a, b = 'foo', 'föö' %}").module
m.a
Out[7]:
'foo'
In [8]:
m.b
Out[8]:
'föö'
In [9]:
def guess_autoescape(template_name):
if template_name is None or '.' not in template_name:
return False
ext = template_name.rsplit('.', 1)[1]
return ext in ('html', 'htm', 'xml')
Version 3.1.0
Released 2022-03-24
Drop support for Python 3.6. #1534
Remove previously deprecated code. #1544
WithExtension and AutoEscapeExtension are built-in now.In [10]:
env = Environment(autoescape=guess_autoescape,
loader=PackageLoader('tutoapp') )
In [11]:
from jinja2 import BaseLoader, TemplateNotFound
from os.path import join, exists, getmtime
In [12]:
class MyLoader(BaseLoader):
def __init__(self, path):
self.path = path
def get_source(self, environment, template):
path = join(self.path, template)
if not exists(path):
raise TemplateNotFound(template)
mtime = getmtime(path)
with file(path) as f:
source = f.read().decode('utf-8')
return source, path, lambda: mtime == getmtime(path)
内置的一些加载器：
jinja2.FileSystemLoader(searchpath, encoding='utf-8', followlinks=False) #文件系统
jinja2.PackageLoader(package_name, package_path='templates', encoding='utf-8') #包
jinja2.DictLoader(mapping) #字典，没啥用
jinja2.FunctionLoader(load_func) #通过一个函数来加载
jinja2.PrefixLoader(mapping, delimiter='/') #有前缀的
jinja2.ChoiceLoader(loaders) #多个加载器，找到第一个匹配
jinja2.ModuleLoader(path) #预编译好的模块自定义过滤器：
In [13]:
def datetimeformat(value, format='%H:%M / %d-%m-%Y'):
return value.strftime(format)
注册到环境中：
In [14]:
env.filters['datetimeformat'] = datetimeformat
<!DOCTYPE html>
<html lang="en">
<head>
<title>My Webpage</title>
</head>
<body>
<ul id="navigation">
{% for item in navigation %}
<li><a href="{{ item.href }}">{{ item.caption }}</a></li>
{% endfor %}
</ul>
<h1>My Webpage</h1>
{{ a_variable }}
{# a comment #}
</body>
</html>默认的语法配置是这样的，可以自己自定义：
{% raw %}{% ... %}{% endraw %}这个是语句{% raw %}{{ ... }}{% endraw %}这个是表达式，打印模板输出{% raw %}{# ... #}{% endraw %}这个是注释部分，不会输出# ... #这个是行语句