デコレーター@の仕組み

Question

デコレーターの@の仕組みを知りたいです。
@が使われた時、裏ではどのような処理が行われているのでしょうか。

例として次のようなデコレーターを作りました。

def decorator(func):
    def wrapper(*args, **kwargs):
        print(func.__name__ + "を実行します")
        func(*args, **kwargs)
    return wrapper


@decorator
def hello(name="someone"):
    print("Hello", name, sep=" ")


hello() 

"""
helloを実行します
Hello someone
"""

この場合、@decoratorというのは、「@decoratorの持つfuncという引数に以下の関数(定義)を入れますよ」というような宣言を行う役割なのでしょうか？

またデコレーターの定義を行う時にある最後のreturn wrapperが理解できません。
wrapperがreturnされるとどうなるのでしょうか。どこにwrapperがreturnされるのでしょうか。

ご教授いただきたいです。宜しくお願い致します。

Answer 1

ただの糖衣構文です。

@decorator
def hello(name="someone"):
    print("Hello", name, sep=" ")


# だいたい同じ
def hello(name="someone"):
    print("Hello", name, sep=" ")
hello = decorator(hello)

そのケースでは、returnされたwrapperがそのままhelloに束縛されます。

---

helloをprintすると意味がつかみやすいかもしれません。

def decorator(func):
    def wrapper(*args, **kwargs):
        print(func.__name__ + "を実行します")
        func(*args, **kwargs)
    return wrapper

@decorator
def hello(name="someone"):
    print("Hello", name, sep=" ")
print(hello)  # デコレータで作ったhello

def hello(name="someone"):
    print("Hello", name, sep=" ")
hello = decorator(hello)
print(hello)  # 「だいたい同じ」方法で作ったhello
  
hello() 

""" =>
<function decorator.<locals>.wrapper at 0x7ff76c22c158>
<function decorator.<locals>.wrapper at 0x7ff76c2c4840>
helloを実行します
Hello someone
"""

Comments

[keip]

hayataka2049さん
ご回答ありがとうございます。
糖衣構文というものがあるんですね。理解できました。
デコレーターとして@を使った場合には、「デコレート対象とした関数自体を更新する」という意味の「hello = decorator(hello)」というような一行も自動的に付加されるという認識で間違いないでしょうか？

[hayataka2049]

その認識でいいと思います。
回答に少し追記して、定義されたhelloがどういうオブジェクトか確認してみました。
<function decorator.<locals>.wrapper at 0x7ff76c22c158>
decorator関数のローカル名前空間に束縛されているwrapperという関数である、ということです。けっきょくこれがデコレータの本質みたいなものです。

[keip]

hayataka2049さん
追記までしていただきありがとうございます。
理解することができました。
追記していただいた内容はしっかり本質を理解する上ですごく助かりました。
丁寧に詳しく解説していただき誠に感謝いたします。