python-dev

# Python開発固有設定

このファイルはPython開発に特化した設定を定義します。

## 公式ドキュメントリファレンス

最新の安定版バージョンは以下の公式ドキュメントを参照してください：

| 技術 | 公式ドキュメント | 用途 |
|-----|----------------|------|
| Python | [Python Downloads](https://www.python.org/downloads/) | バージョン確認・ダウンロード |
| Python Status | [Python Developer's Guide](https://devguide.python.org/versions/) | サポート状況確認 |
| FastAPI | [FastAPI (PyPI)](https://pypi.org/project/fastapi/) | 最新版・リリース履歴 |
| Pydantic | [Pydantic (PyPI)](https://pypi.org/project/pydantic/) | 最新版・リリース履歴 |
| Uvicorn | [Uvicorn (PyPI)](https://pypi.org/project/uvicorn/) | 最新版・リリース履歴 |
| SQLAlchemy | [SQLAlchemy (PyPI)](https://pypi.org/project/SQLAlchemy/) | 最新版・リリース履歴 |
| pytest | [pytest (PyPI)](https://pypi.org/project/pytest/) | 最新版・リリース履歴 |
| ruff | [ruff (PyPI)](https://pypi.org/project/ruff/) | 最新版・リリース履歴 |
| mypy | [mypy (PyPI)](https://pypi.org/project/mypy/) | 最新版・リリース履歴 |
| uv | [uv GitHub](https://github.com/astral-sh/uv) | 公式リポジトリ |

## Python開発固有のルール

### バージョン要件

最新の安定版バージョンは上記の公式ドキュメントリファレンスで確認してください。

- Python: 最新の安定版を使用（[公式サイト](https://www.python.org/downloads/)で確認）
  - 参考: Python 3.12以降を推奨（2025年12月時点）
- 型ヒントを積極的に使用する
- f-stringsを使用する
- PEP 8に準拠する

### コーディング標準
- **ruff**（統合フォーマッター・リンター - Black + isort + flake8統合）
- **mypy strict mode**（厳格な型チェック）
- **PEP 8**（Pythonコーディング規約準拠）
- **型ヒント必須**（すべての関数・変数）
- **docstring**（Google/NumPy形式）

### フレームワーク・ツール
- **FastAPI**（高速API開発）
- **Pydantic**（データバリデーション）
- **SQLAlchemy**（ORM）
- **uv**（高速依存関係管理・Python版管理）
- **ruff**（統合フォーマッター・リンター）
- **mypy**（静的型チェック）
- **pytest**（テストフレームワーク）
- **pytest-asyncio**（非同期テスト）
- **pre-commit**（コミット前品質チェック）

### プロジェクト構成（src/レイアウト）
```
my-project/
├── src/
│   └── myproject/           # パッケージ名
│       ├── __init__.py
│       ├── main.py          # FastAPIアプリケーション
│       ├── config/          # 設定
│       │   ├── __init__.py
│       │   └── settings.py
│       ├── api/             # APIエンドポイント
│       │   ├── __init__.py
│       │   ├── deps.py      # 依存性注入
│       │   └── v1/
│       │       ├──