QRコード生成（qrcode）¶

qrcode ライブラリ¶

• インストール: cf. 公式ドキュメント

  uv add "qrcode[pil]"
  

使い方はめっちゃ簡単。

import qrcode

img = qrcode.make("FastAPI")
img.save("qrcode-test.png") # type: ignore

qrcode-test.png を生成できる。

QR コード生成エンドポイント¶

qrcode を使って、 URL を渡すと QR コードの画像を返すエンドポイントを作る。

from fastapi import FastAPI, Query, Response
from pydantic import HttpUrl
import qrcode
from io import BytesIO

app = FastAPI()

@app.get("/generate-qr")
async def generate_qr(url: HttpUrl = Query(...)):
    img = qrcode.make(str(url))
    buf = BytesIO()
    img.save(buf, format="PNG")  # type: ignore

    return Response(content=buf.getvalue(), media_type="image/png")

io モジュールの BytesIO¶

cf. io — Binary I/O / io.BytesIO

img.save("qrcode-test.png") みたいに書くと、ディスクへの書き込みが行われるので遅いし、同時にリクエストが来たら上書きとかロックとかが起こるかもしれない。
io.BytesIO を使えば、リクエストごとにメモリを確保して処理できる。

なので、下記のように書いて buf に QR コードを書き込んでいくようにするといい。

    img = qrcode.make("FastAPI")
    buf = BytesIO()
    img.save(buf, format="PNG")  # type: ignore

あとは buf を getvalue で bytes にして Response で返すだけ。 getvalue は現在位置に関係なくバッファ全体を返すので、 buf.seek(0) も要らない。

StreamingResponse で buf をそのまま渡す手もあって、その場合は getvalue のコピー 1 回分を減らせる。ただ StreamingResponse が本領を発揮するのは、ジェネレータやファイルをチャンクで逐次返すときで、 QR コードみたいに成果物が全部メモリにある小さいデータだと差はごくわずか。なのでここは素直に Response でOK。