ファイルシステムから直接jinjaテンプレートをロードする方法

Question 1

アプリケーションのテンプレートをロードするようにJinja2を構成する最も簡単な方法は、おおよそ次のようになります。

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

これにより、デフォルト設定のテンプレート環境と、アプリケーションpythonパッケージ内のtemplatesフォルダーでテンプレートを検索するローダーが作成されます。

結局のところ、これはそれほど単純ではありません。テンプレートを含むpythonパッケージを作成/インストールする必要があるため、特にコードを配布する意図がない場合は、不必要に複雑になります。こことここでこのトピックに関するSOの質問を参照できますが、答えはあいまいで満足のいくものではありません。

ナイーブな初心者がやりたいことは、明らかに、パッケージ内のリソースとしてではなく、ファイルシステムから直接テンプレートをロードすることです。 これはどのように行われますか？

Question 2

方法は次のとおりです。のFileSystemLoader代わりにを使用し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、デフォルトの「最も単純な」方法であるように思われるように表現されています。Pythonの初心者にとって、これは野生のガチョウの追跡につながる可能性があります。

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

これが1つのライナーです：

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

次に、テンプレートを別の行にレンダリングすることも、すべてを1行にレンダリングすることもできます。

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

Question 5

Python3.4 +とJinja2-v2.11 +を使用している場合、PythonのpathlibとFilesystemを組み合わせてフローを簡素化できます

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 +）でのみ追加されます。