Pythonのデコレータについて現役エンジニアが解説【初心者向け】

Pythonのデコレータについて、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

今回は、Pythonに関する内容だね！

どういう内容でしょうか？

Pythonのデコレータについて詳しく説明していくね！

お願いします！

目次

1. デコレータとは
2. デコレータの使い方
3. 実際に書いてみよう
4. まとめ

デコレータとは

デコレータとは、関数の中身を書き換えずに関数を修飾するための仕組みです。

ライブラリ内の関数の機能を変更したいときなどに役立ちます。また、自身でクラスメソッドやスタティックメソッドを定義する際には@classmethodや@staticmethodと記述するのがPythonでは一般的となっています。

[PR] Pythonで挫折しない学習方法を動画で公開中

デコレータの使い方

デコレータは以下のような構文で記述できます。

@デコレータ関数名

def 修飾される関数名:

   ・・・

要は既存の関数の先頭に「@デコレータ関数名」と付けるだけで簡単に関数を修飾できるわけです。

ただし、この構文はシンタックスシュガー（糖衣構文）と呼ばれ、簡単に書ける代わりにプログラムの流れが初心者にはわかりにくいというデメリットがあります。

苦い薬（=複雑なプログラム）が砂糖（=簡略化した構文）でコーティングされているというわけですね。

実際に書いてみよう

ここでは本質を理解するために、まずはあえて@を使わずにデコレータを実装してみたいと思います。

これから書くコードはもちろん@を使っても書くことができます。まず、コードの概要をご説明します。

1. デコレータ関数deco()を定義する
2. deco()は関数を引数funcで受け取るように設計する
3. deco()の中にwrapper()関数を定義し、この中で元々の関数を修飾する
4. deco()の戻り値として、修飾した関数のオブジェクトを返すように設計する

ここで、wrapper()は関数内関数なので、引数funcを受け取っている点に注意が必要です。

【@なしでコーディングした場合】

ソースコード

def deco(func):
  def wrapper(*args, **kwargs):
    res = func(*args, **kwargs)
    print("今日はいい天気ですね！")
    return res
  return wrapper
def print_something(str):
  print(str)
print_something = deco(print_something)
print_something("hello!")

実行結果

hello!
今日はいい天気ですね！

通常のprint_something()の出力の後に「今日はいい天気ですね！」という一言を添えることができました。

このような感じで関数を装飾できるのです。それでは次は上のソースコードを@を使って書いてみます。

【@を使ってコーディングした場合】

ソースコード

def deco(func):
  def wrapper(*args, **kwargs):
    res = func(*args, **kwargs)
    print("今日はいい天気ですね！")
    return res
  return wrapper
@deco
def print_something(str):
  print(str)
print_something("hello!")

実行結果

hello!
今日はいい天気ですね！

先ほどと同等の実行結果が得られました。ソースコードの違いは、修飾したい関数定義の先頭に@decoを付けたのと、print_something = deco(print_something)の行を削除した点です。つまり、@decoと記述することによって既存の関数を新しい関数で置き換えているわけですね。

コラム

コスパとタイパ、両方結果的に良くなる良くなる学び方とは？

「スクールは高いし時間も縛られて効率が悪い」と考える方は多いと思います。
もちろん、時間も費用もかかることは間違いありません。
ただ 結果的に無駄な学びにお金も時間もかける方がリスクが高いという考えもあります。

コスパ・タイパ最適化の参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

• ・困ったときに、質問や相談できる相手がいるため挫折しなかった
• ・プロとして必要なスキルのみを深く学べたので無駄がなかった
• ・副業案件の提供と納品までのサポートがあったので目的を達成できた

安価・短期間で広く浅く学んでも意味がありません。 本当に自分の目的が達成できるか、それが重要です。
自分にどのスキルや学び方が合っているか、どんな学習方法かなど、お気軽に 無料相談 に参加してみませんか？

カウンセラー・現役のプロへ、何でも気軽に無料相談可能。 30分か60分お好きな時間が選べて、かつ3回まで すべて無料で ご利用できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き！ 無料相談はこちら

まとめ

この記事ではデコレータについてご紹介しました。

関数内で関数を定義するのでなかなか動きがわかりづらいデコレータですが、一度理解してしまえば非常に便利な機能です。最初は少し大変かもしれませんが、頑張って理解するようにしましょう。

この記事を監修してくれた方

内容分かりやすくて良かったです！

ゆかりちゃんも分からないことがあったら質問してね！

分かりました。ありがとうございます！

TechAcademyでは、初心者でも、Pythonを使った人工知能（AI）や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

プログラミングを独学で学習していて、このように感じた経験はないでしょうか？

• ・調べてもほしい情報が見つからない
• ・独学のスキルが実際の業務で通用するのか不安
• ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、マンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう カウンセラーやエンジニア・デザイナー があなたの相談に真摯に向き合います。

「自分に合っているか診断してほしい」
「漠然としているが話を聞いてみたい」
こんなささいな悩みでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。（1週間限定）

今なら参加者限定の割引特典付き！ 無料相談を予約する