[tool.pyright]
# Pythonバージョン
pythonVersion = "3.11"

# 型チェックの厳しさ（off/basic/standard/strict）
typeCheckingMode = "basic"  # 最初は basic がおすすめ

# 仮想環境のパス
venvPath = "."
venv = ".venv"

# チェック対象
include = ["myproject"]

# 除外対象
exclude = [
"**/node_modules",
"**/__pycache__",
"**/migrations",  # Djangoマイグレーション除外
]

# 基本型
def calculate_age(birth_year: int) -> int:
return 2025 - birth_year

# リスト（Python 3.9+）
def get_scores() -> list[int]:
return [85, 90, 95]

# 辞書
def get_user() -> dict[str, str]:
return {"name": "Alice", "email": "alice@example.com"}

# Optional（値 or None）- Python 3.10+推奨
def find_user(user_id: int) -> str | None:
if user_id > 0:
    return "Alice"
return None

# Union型（Python 3.10+推奨記法）
def process_data(value: str | int) -> str:
return str(value)

# 古い書き方（非推奨）
from typing import Union, Optional

def old_style(value: Union[str, int]) -> Optional[str]:
return str(value) if value else None

# 新しい書き方（推奨）
def new_style(value: str | int) -> str | None:
return str(value) if value else None

from django.http import HttpRequest, HttpResponse
from wagtail.models import Page

# Viewの型ヒント
def my_view(request: HttpRequest) -> HttpResponse:
return HttpResponse("Hello")

# Wagtail Page
def get_page_title(page: Page) -> str:
return page.title

# django-stubsをインストール
uv add --dev django-stubs types-requests

# これでPyrightがDjangoの型を理解してくれる

[tool.pyright]
pythonVersion = "3.11"
typeCheckingMode = "basic"  # basicが現実的
venvPath = "."
venv = ".venv"
include = ["wagtail_template"]
exclude = [
"**/node_modules",
"**/__pycache__",
"**/migrations",
"**/venv",
]

# Django/Wagtailでの現実的な設定（重要！）
reportArgumentType = false          # 引数型チェック緩和
reportAssignmentType = false        # 代入型チェック緩和
reportOptionalCall = false          # Optional系チェック無効
reportMissingImports = false        # importエラー無視

# 上記設定で、Django/Wagtailでも快適に使える

[dependency-groups]
dev = [
"pyright>=1.1.402",
"django-stubs>=5.2.0",
"types-requests>=2.32.0.20250602",
"boto3-stubs>=1.38.30",
"celery-types>=0.23.0",
"pandas-stubs>=2.2.3.250527",
"types-redis>=4.6.0.20241004",
"types-psycopg2>=2.9.21.20250516",
"types-pillow>=10.2.0.20240822",
]

# パターン1: 緩め（型チェックに慣れたい）
[tool.pyright]
typeCheckingMode = "basic"

# パターン2: 標準（バランス重視）
[tool.pyright]
typeCheckingMode = "standard"

# パターン3: 厳格（型安全性重視）
[tool.pyright]
typeCheckingMode = "strict"

# ファイル全体を除外
# pyright: ignore

# 特定行のみ除外
result = some_complex_function()  # pyright: ignore

# 特定のエラーのみ無視
# type: ignore[reportGeneralTypeIssues]

# Python 3.10以降は | None 推奨
def find_user(user_id: int) -> str | None:
if user_id > 0:
    return "Alice"
return None

# 古い書き方（非推奨）
from typing import Optional
def find_user(user_id: int) -> Optional[str]:
...

# 複雑な型は別名をつける
UserDict = dict[str, str | int]

def get_user() -> UserDict:
return {"name": "Alice", "age": 30}