FastAPIパターン

本番指向のFastAPIサービスのためのパターン。

使用するタイミング

• FastAPIアプリを構築またはレビューする場合。
• ルーター、スキーマ、依存関係、データベースアクセスを分割する場合。
• データベースや外部サービスを呼び出す非同期エンドポイントを記述する場合。
• 認証、認可、OpenAPIドキュメント、テスト、またはデプロイ設定を追加する場合。
• FastAPI PRをコピー可能な例とリスクについて確認する場合。

仕組み

FastAPIアプリを明示的な依存関係とサービスコードの上の薄いHTTPレイヤーとして扱います:

• main.py はアプリ構築、ミドルウェア、例外ハンドラー、ルーター登録を担当する。
• schemas/ はPydanticのリクエストとレスポンスモデルを担当する。
• dependencies.py はデータベース、認証、ページネーション、リクエストスコープの依存関係を担当する。
• services/ または crud/ はビジネスと永続化操作を担当する。
• tests/ は本番リソースを開かずに依存関係をオーバーライドする。

小さなルーターと明示的なresponse_model宣言を優先します。レスポンススキーマには生のORMオブジェクト、シークレット、フレームワークのグローバル変数を含めないでください。

プロジェクトレイアウト

app/
|-- main.py
|-- config.py
|-- dependencies.py
|-- exceptions.py
|-- api/
|   `-- routes/
|       |-- users.py
|       `-- health.py
|-- core/
|   |-- security.py
|   `-- middleware.py
|-- db/
|   |-- session.py
|   `-- crud.py
|-- models/
|-- schemas/
`-- tests/

アプリケーションファクトリー

テストとワーカーが制御された設定でアプリをビルドできるように、ファクトリーを使用します。

from contextlib import asynccontextmanager

from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware

from app.api.routes import health, users
from app.config import settings
fr…