L11 ch04 — CRUD エンドポイント

ch04-crud 演習解説

⚠️ 自力でドリルを解いてから読んでください

ドリル 1: @app.patch - 既存タスクを更新する — 模範解答

ドリル名: 01-fill-patch

from fastapi import FastAPI, HTTPException, Request

app = FastAPI()

tasks: list[dict] = []

@app.get("/tasks")
def get_tasks():
    return tasks

@app.get("/tasks/{task_id}")
def get_task(task_id: int):
    for task in tasks:
        if task["id"] == task_id:
            return task
    raise HTTPException(status_code=404, detail="Task not found")

@app.post("/tasks", status_code=201)
async def create_task(request: Request):
    body = await request.json()
    new_task = {"id": len(tasks) + 1, "title": body["title"], "done": body.get("done", False)}
    tasks.append(new_task)
    return new_task

@app.patch("/tasks/{task_id}")
async def update_task(task_id: int, request: Request):
    body = await request.json()
    for t in tasks:
        if t["id"] == task_id:
            t.update({"title": body["title"], "done": body["done"]})
            return t
    raise HTTPException(status_code=404, detail="Task not found")

@app.delete("/tasks/{task_id}", status_code=204)
def delete_task(task_id: int):
    tasks[:] = [t for t in tasks if t["id"] != task_id]

ドリル 1: @app.patch - 既存タスクを更新する — 解説

ドリル名: 01-fill-patch

@app.patch("/tasks/{task_id}")
def update_task(task_id: int, task: Task):
    tasks = load()
    for t in tasks:
        if t["id"] == task_id:
            t.update(task.model_dump())
            save(tasks)
            return t
    raise HTTPException(status_code=404, detail="Task not found")

> ポイント: PATCH は一部のフィールドだけ更新する HTTP メソッド（PUT は全フィールドの置換）。404 は「リソースが見つからない」を表す標準的なステータスコード。

>

> 補足: この実装は task.model_dump() で全フィールドを送る前提になっている。「送ったフィールドだけを更新する」厳密な PATCH を実装するには Optional フィールドと exclude_unset=True が必要になる（応用）。

ドリル 2: GET /tasks/{id} + HTTPException 404 - 1件取得 — 模範解答

ドリル名: 02-add-get-one

from fastapi import FastAPI, HTTPException, Request

app = FastAPI()

tasks: list[dict] = []

@app.get("/tasks")
def get_tasks():
    return tasks

@app.get("/tasks/{task_id}")
def get_task(task_id: int):
    for task in tasks:
        if task["id"] == task_id:
            return task
    raise HTTPException(status_code=404, detail="Task not found")

@app.post("/tasks", status_code=201)
async def create_task(request: Request):
    body = await request.json()
    new_task = {"id": len(tasks) + 1, "title": body["title"], "done": body.get("done", False)}
    tasks.append(new_task)
    return new_task

@app.patch("/tasks/{task_id}")
async def update_task(task_id: int, request: Request):
    body = await request.json()
    for t in tasks:
        if t["id"] == task_id:
            t.update({"title": body["title"], "done": body["done"]})
            return t
    raise HTTPException(status_code=404, detail="Task not found")

@app.delete("/tasks/{task_id}", status_code=204)
def delete_task(task_id: int):
    tasks[:] = [t for t in tasks if t["id"] != task_id]

ドリル 2: GET /tasks/{id} + HTTPException 404 - 1件取得 — 解説

ドリル名: 02-add-get-one

@app.get("/tasks/{task_id}")
def get_task(task_id: int):
    tasks = load()
    for task in tasks:
        if task["id"] == task_id:
            return task
    raise HTTPException(status_code=404, detail="Task not found")

> ポイント: GET /tasks と GET /tasks/{task_id} は別のエンドポイント。FastAPI はパスの形で自動的に振り分ける。raise を return にしてしまうとエラーにならないので注意。

ドリル 3: クエリパラメータでフィルタ - 検索エンドポイント — 模範解答

ドリル名: 03-add-search

from fastapi import FastAPI, HTTPException, Request

app = FastAPI()

tasks: list[dict] = []

@app.get("/tasks")
def get_tasks(q: str | None = None):
    if not q:
        return tasks
    return [t for t in tasks if q.lower() in t["title"].lower()]

@app.get("/tasks/{task_id}")
def get_task(task_id: int):
    for task in tasks:
        if task["id"] == task_id:
            return task
    raise HTTPException(status_code=404, detail="Task not found")

@app.post("/tasks", status_code=201)
async def create_task(request: Request):
    body = await request.json()
    new_task = {"id": len(tasks) + 1, "title": body["title"], "done": body.get("done", False)}
    tasks.append(new_task)
    return new_task

@app.patch("/tasks/{task_id}")
async def update_task(task_id: int, request: Request):
    body = await request.json()
    for t in tasks:
        if t["id"] == task_id:
            t.update({"title": body["title"], "done": body["done"]})
            return t
    raise HTTPException(status_code=404, detail="Task not found")

@app.delete("/tasks/{task_id}", status_code=204)
def delete_task(task_id: int):
    tasks[:] = [t for t in tasks if t["id"] != task_id]

ドリル 3: クエリパラメータでフィルタ - 検索エンドポイント — 解説

ドリル名: 03-add-search

@app.get("/tasks")
def get_tasks(q: str | None = None):
    if not q:
        return tasks
    return [t for t in tasks if q.lower() in t["title"].lower()]

ポイント

q: str | None = None — FastAPI はクエリパラメータをそのまま関数の引数として受け取る。None がデフォルトなので省略可能になる。

if not q: — None（省略）と ""（空文字）はどちらも falsy。まとめて「全件返す」条件にできる。

q.lower() in t["title"].lower() — 両方を小文字化してから比較することで大文字小文字を無視した部分一致になる。

設計上の選択肢

大文字小文字を区別したい場合: q in t["title"] のまま（.lower() を外す）

完全一致にしたい場合: in を == に変える

別解: filter() を使う

return list(filter(lambda t: q.lower() in t["title"].lower(), tasks))

リスト内包表記と同じ結果。好みの問題だが、リスト内包表記の方が Python らしく読みやすい。

チェックポイント（自問自答用）

• q="" を渡したとき、全件返るか？（not "" は True なので全件になる）
• 日本語の大文字小文字変換は .lower() で問題ないか？（ひらがな・カタカナは .lower() で変化しないので問題なし）

ドリル 4: HTTPException 400 - 入力値のバリデーション — 模範解答

ドリル名: 04-add-validation

from fastapi import FastAPI, HTTPException, Request

app = FastAPI()

tasks: list[dict] = []

@app.get("/tasks")
def get_tasks():
    return tasks

@app.get("/tasks/{task_id}")
def get_task(task_id: int):
    for task in tasks:
        if task["id"] == task_id:
            return task
    raise HTTPException(status_code=404, detail="Task not found")

@app.post("/tasks", status_code=201)
async def create_task(request: Request):
    body = await request.json()
    if not body.get("title"):
        raise HTTPException(status_code=400, detail="title is required")
    if "done" in body and not isinstance(body["done"], bool):
        raise HTTPException(status_code=400, detail="done must be a boolean")
    new_task = {"id": len(tasks) + 1, "title": body["title"], "done": body.get("done", False)}
    tasks.append(new_task)
    return new_task

@app.patch("/tasks/{task_id}")
async def update_task(task_id: int, request: Request):
    body = await request.json()
    for t in tasks:
        if t["id"] == task_id:
            t.update({"title": body["title"], "done": body["done"]})
            return t
    raise HTTPException(status_code=404, detail="Task not found")

@app.delete("/tasks/{task_id}", status_code=204)
def delete_task(task_id: int):
    tasks[:] = [t for t in tasks if t["id"] != task_id]

ドリル 4: HTTPException 400 - 入力値のバリデーション — 解説

ドリル名: 04-add-validation

@app.post("/tasks", status_code=201)
async def create_task(request: Request):
    body = await request.json()
    if not body.get("title"):
        raise HTTPException(status_code=400, detail="title is required")
    if "done" in body and not isinstance(body["done"], bool):
        raise HTTPException(status_code=400, detail="done must be a boolean")
    new_task = {"id": len(tasks) + 1, "title": body["title"], "done": body.get("done", False)}
    tasks.append(new_task)
    return new_task

ポイント

not body.get("title") — None（キーなし）と ""（空文字）の両方が falsy なのでまとめて検査できる。

isinstance(body["done"], bool) — Python の bool は int のサブクラス。isinstance(1, int) は True だが isinstance(1, bool) は False。この順序で確認することで "yes" も 1 も弾ける。

"done" in body — done が省略されたリクエストは通す。渡されたときだけ型チェックする。

判断の選択肢（解説）

バリデーションの実装方法は複数ある:

• if not body.get("title"): ← 今回の実装（簡潔）
• if "title" not in body or body["title"] == "": ← 明示的で読みやすい
• Pydantic の validator を使う ← 本格的だが pydantic トピックの知識が必要

どれも正解。「なぜその書き方を選んだか」を説明できることが大事。

ドリル 5: CRUD + HTTPException + 連番ID - タスク管理 API を白紙から — 模範解答

ドリル名: 05-build-task-crud

"""タスク管理 API 模範実装 (1例)。

これは「答えの一例」。実装方法は自由なので、これと違っていてもテストが通ればOK。
"""
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

class TaskCreate(BaseModel):
    title: str

class TaskUpdate(BaseModel):
    title: str | None = None
    done: bool | None = None

tasks: list[dict] = []
next_id: int = 1

@app.get("/tasks")
def list_tasks():
    return tasks

@app.post("/tasks", status_code=201)
def create_task(payload: TaskCreate):
    global next_id
    task = {"id": next_id, "title": payload.title, "done": False}
    next_id += 1
    tasks.append(task)
    return task

def _find(task_id: int) -> dict:
    for t in tasks:
        if t["id"] == task_id:
            return t
    raise HTTPException(status_code=404, detail="not found")

@app.patch("/tasks/{task_id}")
def update_task(task_id: int, payload: TaskUpdate):
    task = _find(task_id)
    if payload.title is not None:
        task["title"] = payload.title
    if payload.done is not None:
        task["done"] = payload.done
    return task

@app.delete("/tasks/{task_id}", status_code=204)
def delete_task(task_id: int):
    task = _find(task_id)
    tasks.remove(task)
    return None

ドリル 5: CRUD + HTTPException + 連番ID - タスク管理 API を白紙から — 解説

ドリル名: 05-build-task-crud

ゼロから書く時の思考プロセス

1. データ構造を決める: list[dict] が最もシンプル。後で DB に置き換えるならクラス化も。
2. 状態管理: グローバル変数 tasks と next_id。FastAPI の Depends を使う方法もあるがオーバースペック。
3. 入力バリデーション: Pydantic の BaseModel で型と必須項目を宣言。手動で dict から取ると壊れやすい。
4. エラーハンドリング: HTTPException で 404 などを返す。
5. ステータスコード: 作成は 201、削除は 204。デコレータの status_code パラメータで指定。

ファイル分割の判断

このドリルでは「main.py 1ファイル」と縛っている。理由は:

• 1ドリル = 1つの仕様 → 分割すると採点 (テスト) が複雑になる
• 分割の練習はもっと大きな演習で

ただし実務では models.py / services.py / routers.py に分けるのが普通。

実装が複数あり得る点

• データ保持: list[dict] / dict[int, dict] / class TaskRepo
• ID 採番: グローバル変数 / 関数の attribute / itertools.count()
• 検索: 線形検索 / dict での O(1) ルックアップ

テストが叩く I/F が同じなら、どれも正解。