FastAPIとJinja2のインストール
FastAPIとJinja2をインストールするには、Pythonのパッケージ管理ツールであるpipを使用します。以下のコマンドを実行してください。
pip install fastapi
pip install jinja2
これらのコマンドは、それぞれFastAPIとJinja2をインストールします。FastAPIは、Pythonで高性能なAPIを簡単に構築するためのモダンで高速（高性能）なWebフレームワークです。一方、Jinja2は、Pythonのための強力で柔軟なテンプレートエンジンです。
これらのパッケージが正常にインストールされたことを確認するには、Pythonインタプリタを開き、次のように入力します。
import fastapi
import jinja2
これらのコマンドがエラーなく実行されれば、FastAPIとJinja2のインストールは成功しています。次に、これらを使用してWebアプリケーションを構築する方法を見ていきましょう。次の小見出しでは、Jinja2Templatesの利用について説明します。お楽しみに！
Jinja2Templatesの利用
FastAPIとJinja2を組み合わせて、動的なHTMLページを生成することができます。これを実現するためには、FastAPIのJinja2Templatesクラスを利用します。
まず、テンプレートを格納するディレクトリを作成します。このディレクトリは通常、アプリケーションのルートディレクトリに配置され、templatesという名前がつけられます。
次に、Jinja2Templatesクラスのインスタンスを作成します。このインスタンスは、テンプレートディレクトリへのパスを引数として受け取ります。
from fastapi import FastAPI
from fastapi.templating import Jinja2Templates
app = FastAPI()
templates = Jinja2Templates(directory="templates")
これで、Jinja2Templatesのインスタンスが作成され、テンプレートをレンダリングする準備が整いました。テンプレートをレンダリングするには、TemplateResponseを使用します。これはFastAPIのレスポンスモデルの一つで、HTMLコンテンツをクライアントに返すことができます。
from fastapi import Request
from fastapi.responses import TemplateResponse
@app.get("/")
def read_root(request: Request):
return templates.TemplateResponse("index.html", {"request": request})
このコードは、ルートURL（/）にGETリクエストが来たときに、index.htmlという名前のテンプレートをレンダリングします。テンプレートに渡されるデータは、第二引数の辞書によって指定されます。この例では、requestオブジェクトがテンプレートに渡されます。
以上が、FastAPIとJinja2を用いてテンプレートを利用する基本的な方法です。次の小見出しでは、テンプレートの作成と利用について詳しく説明します。お楽しみに！
テンプレートの作成と利用
FastAPIとJinja2を用いてテンプレートを作成し、それを利用する方法を見ていきましょう。
まず、templatesディレクトリにHTMLファイルを作成します。このファイルがテンプレートとなります。例えば、index.htmlという名前のファイルを作成し、以下のような内容を記述します。
<!DOCTYPE html>
<html>
<head>
<title>FastAPI with Jinja2</title>
</head>
<body>
<h1>Welcome to FastAPI with Jinja2!</h1>
</body>
</html>
次に、このテンプレートをFastAPIのエンドポイントから利用します。先程作成したJinja2TemplatesのインスタンスとTemplateResponseを使用して、テンプレートをレンダリングします。
@app.get("/")
def read_root(request: Request):
return templates.TemplateResponse("index.html", {"request": request})
このコードは、ルートURL（/）にGETリクエストが来たときに、index.htmlという名前のテンプレートをレンダリングします。テンプレートに渡されるデータは、第二引数の辞書によって指定されます。この例では、requestオブジェクトがテンプレートに渡されます。
以上が、FastAPIとJinja2を用いてテンプレートを作成し利用する基本的な方法です。次の小見出しでは、url_for関数の活用について詳しく説明します。お楽しみに！
url_for関数の活用
FastAPIとJinja2を用いて、テンプレート内で動的なURLを生成する方法を見ていきましょう。これを実現するためには、url_for関数を利用します。
url_for関数は、エンドポイントの名前と任意のパスパラメータを引数に取り、対応するURLを生成します。この関数は、テンプレート内でリンクを動的に生成する際に非常に便利です。
まず、FastAPIのエンドポイントに名前を付ける方法を見てみましょう。エンドポイントに名前を付けるには、ルーティングデコレータ（@app.getや@app.postなど）のnameパラメータを使用します。
@app.get("/items/{item_id}", name="item_detail")
async def read_item(item_id: int):
return {"item_id": item_id}
このコードは、/items/{item_id}というパスにGETリクエストが来たときに、read_item関数を呼び出します。このエンドポイントの名前はitem_detailとなります。
次に、このエンドポイントの名前をurl_for関数で使用して、テンプレート内でURLを生成します。
<a href="{{ url_for('item_detail', item_id=1) }}">Item 1</a>
このコードは、item_detailエンドポイントに対応するURL（この場合、/items/1）へのリンクを生成します。
以上が、FastAPIとJinja2を用いてurl_for関数を活用する基本的な方法です。これにより、テンプレート内で動的なURLを簡単に生成することができます。次の小見出しでは、さらに詳しく説明します。お楽しみに！