Pythonの関数デコレータとは？基本の仕組みと使い方をわかりやすく解説

Pythonでは、デコレータ（decorator）を使うことで、関数・メソッド・クラスといった呼び出し可能オブジェクト（callable）の振る舞いを、本体のコードを書き換えることなく拡張・変更できます。デコレータとは、簡単に言えば「関数やクラスを修飾（modify）するために使われる呼び出し可能なオブジェクト」のことです。

特に関数デコレータは、関数への参照を引数として受け取り、その関数をラップ（wrap）した新しい関数を返す関数です。これにより、元の関数に手を加えずに、前後の処理を追加できます。

デコレータの基本的な構文

まず、次のようなコードを見てみましょう。

コード例1

@decorator
def func(arg):
    return "value"

このコードは、実質的に以下のコードと同じ意味を持ちます。

コード例2

def func(arg):
    return "value"
func = decorator(func)

つまり、デコレータとは「関数を引数として受け取り、別の関数を返すだけの関数」であることがわかります。@構文は、この置き換え処理を簡潔に記述するための糖衣構文（シンタックスシュガー）なのです。

ラップして前後に処理を追加する

デコレータは、対象の関数を「装飾」または「ラップ」し、ラップされた関数が実行される前後に任意のコードを実行できるようにします。以下の例で具体的に確認してみましょう。

def our_decorator(func):
    def function_wrapper(x):
        print("Before calling " + func.__name__)
        func(x)
        print("After calling " + func.__name__)
    return function_wrapper

def foo(x):
    print("Hi, foo has been called with " + str(x))

print("We call foo before decoration:")
foo("Hi")

print("We now decorate foo with f:")
foo = our_decorator(foo)

print("We call foo after decoration:")
foo(90)

出力結果

We call foo before decoration:
Hi, foo has been called with Hi
We now decorate foo with f:
We call foo after decoration:
Before calling foo
Hi, foo has been called with 90
After calling foo

このように、デコレータを適用すると、元の関数 foo の実行前後に print 文による追加処理が挟まれていることが確認できます。

最もシンプルなデコレータ

上記の例が少し複雑に感じた方のために、考えられる最もシンプルなデコレータを紹介します。

def null_decorator(func):
    return func

null_decorator は呼び出し可能なオブジェクト（関数）であり、別の呼び出し可能オブジェクトを入力として受け取り、何も変更せずにそのまま返します。

次に、このシンプルなデコレータを使って、別の関数を装飾（ラップ）してみましょう。

def null_decorator(func):
    return func

def greet():
    return "Hello, Python!"

greet = null_decorator(greet)
>>> greet()
'Hello, Python!'

ここでは greet 関数を定義した直後、null_decorator 関数に通すことで即座にデコレートしています。

@構文で1ステップでデコレートする

上記のように、greet に対して明示的に null_decorator を呼び出してから変数を再代入する代わりに、Pythonの @ 構文を使えば、関数を1ステップでデコレートでき、より簡潔に書けます。

@null_decorator
def greet():
    return "Hello, Python!"

>>> greet()
'Hello, Python!'

@null_decorator を関数定義の直前に置くだけで、greet = null_decorator(greet) と同じ処理が自動的に行われます。これがPythonのデコレータ構文の本質であり、ロギング、認証チェック、実行時間の計測など、さまざまな場面で活用される強力な機能です。