シラバス レッスン 250 中 63 · Python らしいコード、テスト、総仕上げ
Python らしいコード、テスト、総仕上げ

デコレーター

デコレーターは、元の関数の本体を変えずに、別の関数を包んでふるまいを追加する関数です。def の上に置く @ 構文で適用します。

形はいつも同じです:関数を受け取り、何か余分なことをしてから元の関数を呼ぶ内側の wrapper を定義し、その wrapper を返します。

def shout(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        return result.upper()
    return wrapper

@shout
def greet(name):
    return f"hi {name}"

print(greet("ada"))   # HI ADA

greet の上に @shout と書くのは、greet = shout(greet) の略記にすぎません。それ以降、greet という名前は wrapper を指します。

wrapper の中の *args, **kwargs のおかげで、元の関数が取る引数を何でも受け取り、そのまま転送できます。これでデコレーターが汎用的になります。

functools.wraps

包むと関数が置き換わるので、元の関数の名前と docstring が wrapper の後ろに隠れてしまいます。wrapper 自体を functools.wraps(func) で修飾すればメタデータがコピーされて直ります。本物のデコレーターでは必ずこうしましょう:

import functools

def double(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs) * 2
    return wrapper

@double
def add(a, b):
    """Add two numbers."""
    return a + b

print(add(3, 4))        # 14
print(add.__name__)     # 'add'  (preserved by wraps)
あなたの番

包んだ関数の戻り値を 2 倍にするデコレーター double を書いてください。包まれた関数が __name__ を保つように functools.wraps を使います。それから a + b を返す関数 add(a, b) に @double で適用し、add(3, 4) が 14 を返し、add.__name__ が "add" のままになるようにします。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。