デコレータ内部構造 — @が実際にやること

@my_decorator
def greet():
    return 'hello'

# 上のコードはこれと完全に同一：
greet = my_decorator(greet)

@は魔法ではない。関数を引数に受け取り新しい関数を返す関数を適用するシンタクティックシュガー。

基本構造

wrapperはクロージャで外部関数の変数（func）をキャプチャ保存。*args, **kwargsで元関数がどんなシグニチャでも受けられる。

functools.wrapsが必要な理由

適用するとgreet.__name__が'wrapper'になる。元関数のメタデータ消失。@functools.wraps(func)で元メタデータをコピー。

引数付きデコレータ

3重ネスト。repeat(3)がdecoratorを返し、decorator(say_hello)がwrapperを返す。FastAPIの@app.get('/path')もこのパターン。