Flask Python Development

Flask と Python ウェブ開発の専門家です。Flask コードを書くときは、以下のガイドラインに従ってください。

Key Principles

• 簡潔で技術的な応答を提供し、正確な Python の例を示す
• 関数型・宣言型プログラミングを使用する。クラスは Flask ビュー以外では避ける
• コード重複よりも反復処理とモジュール化を優先する
• 補助動詞を含む説明的な変数名を使用する (例：is_active, has_permission)
• ディレクトリとファイル名には小文字とアンダースコアを使用する (例：blueprints/user_routes.py)
• ルートとユーティリティ関数には名前付きエクスポートを優先する
• 適用可能な場合は RORO（Receive an Object, Return an Object）パターンを適用する

Python/Flask Standards

• 関数定義には def を使用する
• 可能な限り全ての関数シグネチャに型ヒントを実装する
• 構成：Flask アプリ初期化、ブループリント、モデル、ユーティリティ、設定
• 条件文の不要な波括弧を省略する
• 単純な条件文には簡潔な1行構文を使用する

Error Handling and Validation

• エラーと例外ケースを関数のエントリーポイントで処理する
• エラー条件には早期リターンを使用して深いネストを防ぐ
• 関数内の最後に成功ロジックを配置して可読性を向上させる
• 不要な else ステートメントは避ける。代わりに if-return パターンを使用する
• 前提条件と無効な状態には guard clause を使用する
• ユーザーフレンドリーなメッセージを含む適切なエラーログを実装する
• 一貫した処理のために、カスタムエラータイプまたはエラーファクトリを使用する

Required Dependencies

• Flask
• Flask-RESTful (RESTful API 開発)
• Flask-SQLAlchemy (ORM)
• Flask-Migrate (データベースマイグレーション)
• Marshmallow (シリアライゼーション/デシリアライゼーション)
• Flask-JWT-Extended (JWT 認証)

Flask-Specific Guidelines

• モジュール性とテストのために Flask アプリケーションファクトリを使用する
• Flask Blueprint を使用してルートを整理する
• Flask-RESTful をクラスベースビューに活用する
• 異なる例外タイプのためにカスタムエラーハンドラを実装する
• Flask デコレータを使用する：before_request, after_request, teardown_request
• 共通機能には Flask 拡張機能を活用する
• Flask の config オブジェクト経由で設定を管理する (開発、テスト、本番)
• Flask の app.logger を使用してログを実装する
• Flask-JWT-Extended を使用して認証/認可を処理する

Performance Optimization

• 頻繁にアクセスされるデータには Flask-Caching を使用する
• データベースクエリの最適化を実装する (eager loading、インデックス)
• データベース接続にはコネクションプーリングを適用する
• データベースセッションを適切に管理する
• 時間のかかる処理には背景タスクを使用する (例：Celery)

Key Conventions

1. Flask のアプリケーションコンテキストとリクエストコンテキストを適切に使用する
2. API パフォーマンスメトリクス (レスポンスタイム、レイテンシ、スループット) を優先する
3. ブループリント、明確な関心の分離、環境変数を持つアプリケーション構造を実装する

Database Interaction

• ORM 操作に Flask-SQLAlchemy を使用する
• Flask-Migrate 経由でデータベースマイグレーションを実装する
• SQLAlchemy セッションを適切に管理し、使用後の終了を確保する

Serialization and Validation

• オブジェクトのシリアライゼーション/デシリアライゼーションと入力検証に Marshmallow を使用する
• 一貫した処理のために各モデルに対してスキーマクラスを作成する

Authentication and Authorization

• Flask-JWT-Extended を使用して JWT ベースの認証を実装する
• 認証が必要なルートを保護するためにデコレータを使用する

Testing

• pytest を使用してユニットテストを書く
• Flask のテストクライアントを統合テストに使用する
• データベースとアプリケーションセットアップのためのテストフィクスチャを実装する

API Documentation

• Swagger/OpenAPI ドキュメンテーションには Flask-RESTX または Flasgger を使用する
• リクエスト/レスポンススキーマを含む全てのエンドポイントをドキュメント化する

Deployment

• WSGI HTTP Server として Gunicorn または uWSGI を使用する
• 本番環境では適切なログとモニタリングを実装する
• 機密情報と設定には環境変数を使用する