【Python中級】デコレーターとは？関数をより柔軟に扱うテクニック【レッスンF-2】

Q: Pythonのデコレーターは何のために使うのですか？

デコレーターは、関数の振る舞いを変更・拡張するために使います。例えば、ログ出力やエラーハンドリング、認証処理などを関数の外から追加できるため、コードをより効率的に、かつ読みやすく保つことができます。

Q: Pythonのデコレーターはクラスに対しても使えますか？

はい、デコレーターは関数だけでなく、クラスにも適用できます。たとえば、クラス全体の振る舞いをカスタマイズしたい場合に、クラスデコレーターを使用することで、インスタンスの生成処理などに共通ロジックを追加できます。

Q: 自作のデコレーター関数を作るときに注意すべきポイントは？

自作デコレーターでは、元の関数の情報（関数名やドキュメント文字列など）を維持するために、functools.wrapsを使用することが推奨されます。これを忘れると、デバッグやドキュメント生成時に不便になることがあります。

ながみえ

Flaskの学習に入る前にもう少しだけPythonの学習をしましょう。

今回はデコレーターについて見ていきます。

Lesson１：基礎文法編
Lesson２：制御構造編
Lesson３：関数とスコープ編
Lesson４：データ構造編
Lesson５：オブジェクト指向編
Lesson F：Flask学習の準備編
・Lesson F-2：可変長引数を理解しよう
・Lesson F-2：デコレーターを理解しよう ◁今回はココ

Pythonの記事一覧

Python学習カテゴリの親ページ用アイキャッチ画像（テキスト＆問題集）、記事一覧へのリンク案内

Flaskの記事一覧

前のページ>>

デコレーターの基本｜仕組みと書き方を初心者向けに解説

この章ではPythonにおける「デコレーター」の意味や使い方を学習します。必要ない方はここをクリックして練習問題へ飛びましょう。

【Python】勉強猫がノートパソコンを前にして学習を始める様子。記事内の学習スタート用イラスト

Pythonでは関数を定義して使うだけでなく、関数に新たな機能を追加するテクニックも存在します。

このような応用的な機能のひとつが「デコレーター」です。

デコレーターは関数の前に「@」を付けて使う、Python独自の強力な文法であり、「ある関数に、別の処理を付け加える」というものです。

Pythonでは関数もオブジェクトとして扱えるため、関数を引数に渡したり、返したりすることができます。

これを活用して、関数の前後に処理を追加するような「ラッパー関数」を使うのが、デコレーターの基本アイデアです。

これは「関数を引数として受け取り、関数を返す」関数の仕組みを応用しており、Lesson3で学んだ関数のスコープや関数の受け渡しの知識が土台になっています。

デコレーターの基本構文

デコレーターは以下のように定義し、使用します：

def デコレーター関数(func): # デコレーター関数の定義
    def wrapper():
        # 関数の前処理
        print("前処理を実行します")
        # 本体関数の実行
        func()
        # 関数の後処理
        print("後処理を実行します")
    return wrapper

@デコレーター関数
def 本体関数(): # 本体関数の定義
    print("メインの処理です")

本体関数() # 本体関数の呼び出し

このコードでは、@デコレーター関数 によって、本体関数 本体関数() をラップするように前後に処理を追加しています。

このように「@デコレーター名」を関数の上に書くことで、自動的にそのデコレーターが適用されます。

デコレーターの使用例

デコレーターは様々な場面で活用できます。以下は関数の実行時間を測るデコレーターの例です：

import time # タイムモジュールのインポート

def time_logger(func): # デコレーター関数time_logger()の定義
    def wrapper():
        start = time.time() # 開始時間を計測して変数に代入
        func()              # 本体関数（この場合はsome_process()）の実行
        end = time.time()   # 終了時間を計測して変数に代入
        print(f"実行時間: {end - start:.3f}秒") # 関数の実行時間を出力
    return wrapper

@time_logger
def some_process(): # 関数some_process()の定義
    time.sleep(1)
    print("処理が完了しました")

some_process() # 関数some_process()の呼び出し

このコードを実行すると、以下のように出力されます。

処理が完了しました  
実行時間: 1.001秒

この例では、time_logger というデコレーターを定義し、some_process の実行時間を測定・表示する処理を追加しています。

このように関数の中身には一切手を加えずに、新しい機能を追加できるのがデコレーターの大きな魅力です。

【Python】勉強猫がノートパソコンを見ながら考え込む様子。記事内の休憩用イラスト

組み込みデコレーターの紹介

Pythonには、初めから用意されている「組み込みデコレーター」もあります。よく使われるものとして以下があります：

@staticmethod：静的メソッドを定義
@classmethod：クラスメソッドを定義
@property：属性のようにメソッドを呼び出せるようにする

class Sample:
    @staticmethod
    def greet():
        print("こんにちは！")

Sample.greet()

このように、デコレーターはクラスや関数の振る舞いを変える便利な仕組みとして広く使われています。

まとめ

デコレーターは、関数に対して別の処理を付け加えるための、柔軟で強力な機能です。

ラッパー関数と関数オブジェクトの性質を利用して実現されており、Pythonらしい記述が可能になります。

組み込みデコレーターも活用しながら、コードの再利用性や保守性を高める工夫として、ぜひ習得しておきましょう。

練習問題：デコレーターで処理の前後にメッセージを追加しよう

【Python】勉強猫がノートパソコンに向かい、練習問題に挑戦する様子。記事内の休憩用イラスト

関数の前後にメッセージを表示することで、処理の流れをわかりやすくするプログラムを作成しましょう。

このプログラムでは「デコレーター」を使って、関数の処理前と処理後にメッセージを出力し、さらに処理にかかった時間を表示します。

その上でユーザーから名前を入力してもらい、個別のあいさつを表示します。デコレーターの基本構文と効果を理解しながら実装してみましょう。

問題の詳細条件

以下の要件に従ってコードを完成させてください。

time モジュールをインポートすること。
デコレーター関数 greeting_logger(func) を定義すること。
greeting_logger の中に、処理の前に「=== 処理を開始します ===」、後に「=== 処理が終了しました ===」と出力する処理を記述すること。
time.time() を使って、処理の前後で時間を取得し、その差を「実行時間: ◯◯秒」の形式で表示すること（小数点第2位まで）。
@greeting_logger を使用して、greet_user() 関数にデコレーターを適用すること。
greet_user() 関数の中では、input() を使ってユーザーから名前を入力してもらい、「こんにちは、◯◯さん！ようこそ！」と表示すること。
関数 greet_user() を最後に呼び出すこと。

ただし、以下のような実行結果となるコードを書くこと。

=== 処理を開始します ===
あなたの名前を入力してください：さくら
こんにちは、さくらさん！ようこそ！
=== 処理が終了しました ===
実行時間: 2.01秒

【ヒント】難しいと感じる人だけ見よう

１からコードを組み立てることが難しい場合は、以下のヒントを開いて参考にしましょう。

ヒント１【コードの構成を見る】

正解のコードは上から順に以下のような構成となっています。
（※下記の□はコード内のインデントを表しています）

１：timeモジュールをインポート
２：関数greeting_loggerの定義
　□　ラッパー関数wrapperの定義
　□　□　「=== 処理を開始します ===」と表示
　□　□　開始時間をtime.time()で取得して変数startに代入
　□　□　関数func()を実行
　□　□　終了時間をtime.time()で取得して変数endに代入
　□　□　「=== 処理が終了しました ===」と表示
　□　□　実行時間を「実行時間: ◯◯秒」の形式で表示
　□　ラッパー関数wrapperを返す
３：greet_user関数にデコレーターgreeting_loggerを適用
４：関数greet_userの定義
　□　input関数でユーザーから名前を入力させ、変数nameに代入
　□　f文字列で「こんにちは、◯◯さん！ようこそ！」と出力
５：関数greet_userを呼び出す

ヒント２【穴埋め問題にする】

以下のコードをコピーし、コメントに従ってコードを完成させて下さい。

import time  # timeモジュールを使って処理時間を測定

"""【穴埋め問題１】
ここにデコレーター関数greeting_loggerを定義してください。
この関数はラッパー関数wrapperを内部に持ち、処理の前後にメッセージを表示し、処理時間を表示します。
"""

# デコレーターを適用
@greeting_logger
def greet_user():
    """ユーザーに名前を聞いてあいさつする関数"""
    name = input("あなたの名前を入力してください：")  # 入力
    print(f"こんにちは、{name}さん！ようこそ！")  # あいさつ

greet_user()

このヒントを見てもまだ回答を導き出すのが難しいと感じる場合は、先に正解のコードと解説を見て内容を理解するようにしましょう。

問題の答え合わせと解説

この問題の一つの正解例とそのコードの解説を以下に示します。

一つの正解例

例えば以下のようなプログラムが考えられます。

正解コード

# timeモジュールをインポートして処理時間を測定できるようにする
import time

# デコレーター関数：関数の前後でメッセージを表示する
def greeting_logger(func):
    # 内部関数（ラッパー関数）を定義
    def wrapper():
        print("=== 処理を開始します ===")  # 前処理の表示
        start = time.time()  # 開始時間を記録
        func()               # 本体関数の実行
        end = time.time()    # 終了時間を記録
        print("=== 処理が終了しました ===")  # 後処理の表示
        print(f"実行時間: {end - start:.2f}秒")  # 実行時間の出力
    return wrapper  # ラッパー関数を返す

# デコレーターを使って関数に機能を追加
@greeting_logger
def greet_user():
    """ユーザーの名前を聞いて、あいさつをする関数"""
    name = input("あなたの名前を入力してください：")  # 入力の取得
    print(f"こんにちは、{name}さん！ようこそ！")  # あいさつメッセージ

# 関数を実行
greet_user()

正解例の詳細解説

このコードはPythonの「デコレーター」を使って、関数に追加の処理を組み込む方法を学ぶためのものです。

コードをブロックごとに分けて説明していきます。

詳細解説

１．`import` 文：必要なモジュールの読み込み

import time  # timeモジュールを使って処理時間を測定

このコードでは、Pythonの標準ライブラリ time モジュールを使って「関数の処理にかかる時間」を測定しています。

import は他のプログラム部品を使いたいときに使う命令です。

２．デコレーター関数の定義：`greeting_logger`

def greeting_logger(func):
    def wrapper():
        print("=== 処理を開始します ===")
        start = time.time()
        func()
        end = time.time()
        print("=== 処理が終了しました ===")
        print(f"実行時間: {end - start:.2f}秒")
    return wrapper

この greeting_logger(func) は、別の関数（ここでは greet_user）を引数として受け取り、その前後に処理（ログや時間計測）を追加する関数です。

wrapper() の中で前後にログを表示し、
測定開始 → 本体関数の実行 → 測定終了 → 実行時間の表示

という流れになります。

関数 wrapper を return することで、元の関数が「処理付きの新しい関数」に置き換わります。

３．デコレーターの適用：`@greeting_logger`

@greeting_logger
def greet_user():

ここで、Python特有の「@デコレーター構文」が登場します。
これは次の書き方と同じ意味です：

greet_user = greeting_logger(greet_user)

つまり、greet_user() を呼び出すと、自動的に wrapper() が呼ばれるという仕組みになっています。

このように「関数に別の処理を追加する技術」がデコレーターです。

４．ユーザー入力とあいさつメッセージの表示

def greet_user():
    name = input("あなたの名前を入力してください：")
    print(f"こんにちは、{name}さん！ようこそ！")

この関数は、input() で名前を尋ねて、f文字列 であいさつを表示するだけのシンプルな処理です。

デコレーターによって前後にメッセージが追加され、処理時間も測れるようになります。

まとめ

このコードでは、「関数に処理を追加できる」Pythonの強力な機能であるデコレーターを中心に学びました。

関数を引数として受け取る
関数の中で関数を定義する
@構文で関数に追加機能を適用する

など、少し高度ですが、非常に実用的なスキルが詰まっています。

ログ記録、エラーチェック、アクセス制御など、実際のアプリケーションでも頻繁に使われるため、ぜひここで覚えておきましょう。

Pythonの記事一覧

Flaskの記事一覧

前のページ>>

FAQ｜Pythonデコレーターの使い方と実用例

Q1. Pythonのデコレーターは何のために使うのですか？

デコレーターは、関数の振る舞いを変更・拡張するために使います。

例えばログ出力やエラーハンドリング、認証処理などを関数の外から追加できるため、コードをより効率的に、かつ読みやすく保つことができます。

Q2. Pythonのデコレーターはクラスに対しても使えますか？

はい、デコレーターは関数だけでなく、クラスにも適用できます。

たとえば、クラス全体の振る舞いをカスタマイズしたい場合に、クラスデコレーターを使用することで、インスタンスの生成処理などに共通ロジックを追加できます。

Q3. 自作のデコレーター関数を作るときに注意すべきポイントは？

自作デコレーターでは、元の関数の情報（関数名やドキュメント文字列など）を維持するために、functools.wrapsを使用することが推奨されます。

これを忘れると、デバッグやドキュメント生成時に不便になることがあります。

質問用コンタクトフォーム

この記事はAIを用いて書いた記事です。

人間の目による確認も行っていますが、もし間違い等ありましたらご指摘頂けると大変助かります。

Python記事一覧へ戻る
トップページへ戻る