Як завантажити шаблон jinja безпосередньо з файлової системи

Question 1

Документ API jinja на сайті pocoo.org говорить:

Найпростіший спосіб налаштувати Jinja2 для завантаження шаблонів для вашого додатку виглядає приблизно так:

from jinja2 import Environment, PackageLoader
env = Environment(loader=PackageLoader('yourapplication', 'templates'))

Це створить середовище шаблону із налаштуваннями за замовчуванням та завантажувач, який шукає шаблони в папці шаблонів усередині пакету python yourapplication .

Як виявляється, це не так просто, тому що вам доводиться створювати / встановлювати пакет python зі своїми шаблонами, що вносить багато непотрібної складності, особливо якщо ви не маєте наміру розповсюджувати свій код. Ви можете звернутися до SO питань за темою тут і тут , але відповіді є розмитими і незадовільними.

Очевидно, що наївний новачок хоче просто завантажити шаблон безпосередньо з файлової системи, а не як ресурс у пакеті. Як це робиться?

Question 2

Ось як : використовуйте FileSystemLoaderзамість a PackageLoader. Я знайшов приклади в Інтернеті тут і тут . Скажімо, у вас є файл python у тому самому каталозі, що і ваш шаблон:

./index.py
./template.html

Цей index.py знайде шаблон і відтворить його:

#!/usr/bin/python
import jinja2

templateLoader = jinja2.FileSystemLoader(searchpath="./")
templateEnv = jinja2.Environment(loader=templateLoader)
TEMPLATE_FILE = "template.html"
template = templateEnv.get_template(TEMPLATE_FILE)
outputText = template.render()  # this is where to put args to the template renderer

print(outputText)

Виявляється, у документі jinja2 API є розділ, в якому розглядаються всі вбудовані навантажувачі , тому незручно не помітити цього відразу. Але вступ сформульований таким чином, що, PackageLoaderздається, є "найпростішим" методом за замовчуванням. Для новачків пітону це може призвести до переслідування диких гусей.

Question 3

Більш простий спосіб - це безпосередній виклик jinj2.Templateконструктора та використання openдля завантаження файлу:

from jinja2 import Template
with open('template.html.jinja2') as file_:
    template = Template(file_.read())
template.render(name='John')

Question 4

Ось один лайнер:

template = Template(open('template_file.j2').read())

Потім ви можете відтворити шаблон на іншому рядку або для всіх в одному рядку:

rendered = Template(open('template_file.j2').read()).render(var="TEXT")

Question 5

Якщо використовується Python 3.4+ та Jinja2 - v2.11 + - ми можемо поєднати pathlib python та файлову систему для спрощення потоку

from pathlib import Path
...

p = Path(__file__).parent.parent / 'templates' # sample relative path
env = Environment(
    loader=FileSystemLoader(Path(p)))
template = env.get_template('your_file.jinja2')

Мені неприємно користуватися безпосередньо, Template(file)оскільки обробка шаблону спадщини Jinja може не працювати належним чином.

Підтримка Pathlib додана лише в останній версії Jinja - v2.11 +