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

初心者向けにPythonのデコレータについて現役エンジニアが解説しています。デコレータとは、関数の中身を書き換えずに関数を修飾するための仕組みです。関数の引数に関数を指定します。既存の関数の先頭に@デコレータ関数名とすることで、関数を修飾することが出来ます。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

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分すべて無料で できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

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

まとめ

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

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

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

中本賢吾(なかもとけんご)
アジマッチ有限会社 代表取締役社長開発実績:PHPフレームワークによるフランチャイズ企業向け会員制SNS。Shopifyによる海外進出用大規模ネットショップ構築。Vue.jsによる金融機関向け内部アプリ。AWSやLinuxハウジングサーバーでの環境構築。人工知能を利用した画像判別システム。小売チェーン店舗用スマホアプリ。Wordpressによる不動産チェーン店向け賃貸・売買仲介システム。基幹システム移管用データコンバートシステム。小学生がUnityでオリジナルAndroidアプリをGooglePlayでリリース、NHK Whyプログラミング入賞、全国Programing Festival入賞、中学生がノーコードでSNS型PWAアプリリリースなど、ボランティアプログラミング教育活動行っている。

 

大石ゆかり

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

田島悠介

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

大石ゆかり

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

 

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

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

初心者・未経験でもできる。まずはテックアカデミーに相談しよう

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

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

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

「受けてよかった」と感じていただけるよう 厳しい試験を通過した講師 があなたの相談に真摯に向き合います。

「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」

こんな気持ちでも大丈夫です。

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

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