差分
このページの2つのバージョン間の差分を表示します。
| 両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
| python:decorator [2011/06/19 21:19] – ともやん | python:decorator [2020/02/25 11:14] (現在) – [参考文献] ともやん | ||
|---|---|---|---|
| 行 14: | 行 14: | ||
| # 引数 func をラップする関数を定義 | # 引数 func をラップする関数を定義 | ||
| @wraps(func) | @wraps(func) | ||
| - | def _func_wrapper(*args, **kwargs): | + | def _func_info(*args, **kwargs): |
| print '--- func_info ---' | print '--- func_info ---' | ||
| print ' | print ' | ||
| 行 25: | 行 25: | ||
| return result | return result | ||
| # 引数 func をラップした関数を返却 | # 引数 func をラップした関数を返却 | ||
| - | return | + | return |
| # デコレートされた関数を定義 | # デコレートされた関数を定義 | ||
| 行 56: | 行 56: | ||
| def func_info(func): | def func_info(func): | ||
| # 引数 func をラップする関数を定義 | # 引数 func をラップする関数を定義 | ||
| - | def _func_wrapper(*args, **kwargs): | + | def _func_info(*args, **kwargs): |
| print '--- func_info ---' | print '--- func_info ---' | ||
| print ' | print ' | ||
| 行 67: | 行 67: | ||
| return result | return result | ||
| # 引数 func をラップした関数を返却 | # 引数 func をラップした関数を返却 | ||
| - | return | + | return |
| </ | </ | ||
| - | 上記のデコレータでは、引数の func 関数をラップした | + | 上記のデコレータでは、引数の func 関数をラップした |
| ==== 関数のデコレート ==== | ==== 関数のデコレート ==== | ||
| - | デコレータ式で add 関数をデコレートすると、add 関数は @func_info デコレータの | + | デコレータ式で add 関数をデコレートすると、add 関数は @func_info デコレータの |
| <code python> | <code python> | ||
| @func_info | @func_info | ||
| 行 84: | 行 84: | ||
| 実行結果: | 実行結果: | ||
| < | < | ||
| - | < | + | < |
| </ | </ | ||
| デコレータ式は、デコレータの第一引数に関数を指定して、関数ラッパーを生成するコードと等価である。 | デコレータ式は、デコレータの第一引数に関数を指定して、関数ラッパーを生成するコードと等価である。 | ||
| 行 102: | 行 102: | ||
| ==== デコレートされた関数の実行 ==== | ==== デコレートされた関数の実行 ==== | ||
| - | デコレートされた関数を実行するということは、デコレータの | + | デコレートされた関数を実行するということは、デコレータの |
| <code python> | <code python> | ||
| @func_info | @func_info | ||
| 行 120: | 行 120: | ||
| 3 | 3 | ||
| </ | </ | ||
| - | デコレートされていない add1 関数の関数ラッパーを生成して、ラッパーに引数を渡して実行しても同じ結果が得られる。 | + | デコレータを関数として実行する場合、上記と等価なコードは以下のようになる。 |
| <code python> | <code python> | ||
| - | def add1(param1, param2): | + | # func_info(add) は _func_info |
| - | u""" | + | # 以下は _func_info(1, 2) を実行しているのと等価 |
| - | return param1 + param2 | + | print func_info(add)(1, 2) |
| - | + | ||
| - | # _func_wrapperを生成 | + | |
| - | print func_info(add1) | + | |
| - | # _func_wrapperに引数(1, 2)を与えて実行 | + | |
| - | print func_info(add1)(1, 2) | + | |
| - | </ | + | |
| - | 実行結果: | + | |
| - | < | + | |
| - | < | + | |
| - | --- func_info --- | + | |
| - | func: < | + | |
| - | args: (1, 2) kwargs: {} | + | |
| - | result: 3 | + | |
| - | ----------------- | + | |
| - | 3 | + | |
| </ | </ | ||
| ===== ドキュメンテーション文字列が失われないようにする(functools.wraps の使い方) ===== | ===== ドキュメンテーション文字列が失われないようにする(functools.wraps の使い方) ===== | ||
| 行 149: | 行 134: | ||
| def func_info(func): | def func_info(func): | ||
| # 引数 func をラップする関数を定義 | # 引数 func をラップする関数を定義 | ||
| - | def _func_wrapper(*args, **kwargs): | + | def _func_info(*args, **kwargs): |
| print '--- func_info ---' | print '--- func_info ---' | ||
| print ' | print ' | ||
| 行 160: | 行 145: | ||
| return result | return result | ||
| # 引数 func をラップした関数を返却 | # 引数 func をラップした関数を返却 | ||
| - | return | + | return |
| @func_info | @func_info | ||
| 行 175: | 行 160: | ||
| 説明: None | 説明: None | ||
| </ | </ | ||
| - | この問題を解決するには、デコレータ内部の | + | この問題を解決するには、デコレータ内部の |
| <code python> | <code python> | ||
| # -*- coding: utf-8 -*- | # -*- coding: utf-8 -*- | ||
| 行 184: | 行 169: | ||
| # 引数 func をラップする関数を定義 | # 引数 func をラップする関数を定義 | ||
| @wraps(func) | @wraps(func) | ||
| - | def _func_wrapper(*args, **kwargs): | + | def _func_info(*args, **kwargs): |
| print '--- func_info ---' | print '--- func_info ---' | ||
| print ' | print ' | ||
| 行 195: | 行 180: | ||
| return result | return result | ||
| # 引数 func をラップした関数を返却 | # 引数 func をラップした関数を返却 | ||
| - | return | + | return |
| @func_info | @func_info | ||
| 行 211: | 行 196: | ||
| </ | </ | ||
| + | ===== 引数を必要とするデコレータ ===== | ||
| + | デコレータが引数を必要とする場合は、関数を二重にラップする必要がある。(ここでは inc_doc 引数を追加してみる。) | ||
| + | <code python> | ||
| + | # -*- coding: utf-8 -*- | ||
| + | from functools import wraps # python 2.5 以降で利用可能 | ||
| + | |||
| + | # 関数情報を表示するデコレータ | ||
| + | def func_info(inc_doc): | ||
| + | def _func_info(func): | ||
| + | # 引数 func をラップする関数を定義 | ||
| + | @wraps(func) | ||
| + | def __func_info(*func_args, | ||
| + | print '--- func_info ---' | ||
| + | print ' | ||
| + | if inc_doc: | ||
| + | print ' | ||
| + | print ' | ||
| + | # 引数 func を実行 | ||
| + | result = func(*func_args, | ||
| + | print ' | ||
| + | print ' | ||
| + | # 引数 func の実行結果を返却 | ||
| + | return result | ||
| + | # 引数 func をラップした関数を返却 | ||
| + | return __func_info | ||
| + | # 引数 func をラップした関数を返却 | ||
| + | return _func_info | ||
| + | </ | ||
| + | デコレータの引数(inc_docにTrue)を指定してデコレートする。 | ||
| + | <code python> | ||
| + | # デコレートされた関数を定義 | ||
| + | @func_info(True) | ||
| + | def add(param1, param2): | ||
| + | u""" | ||
| + | return param1 + param2 | ||
| + | |||
| + | # デコレートされた関数を実行 | ||
| + | print ' | ||
| + | print add(1, 2) | ||
| + | </ | ||
| + | 実行結果: | ||
| + | < | ||
| + | 関数実行->: | ||
| + | --- func_info --- | ||
| + | func: < | ||
| + | doc: パラメータ1、2を加算した値を返します。 | ||
| + | args: (1, 2) kwargs: {} | ||
| + | result: 3 | ||
| + | ----------------- | ||
| + | 3 | ||
| + | </ | ||
| + | デコレータを関数として実行する場合、上記と等価なコードは以下のようになる。 | ||
| + | <code python> | ||
| + | # func_info(True) は _func_info を返すので | ||
| + | # func_info(True)(add) は _func_info(add) と等価 | ||
| + | # _func_info(add) は __func_info を返すので | ||
| + | # 以下は __func_info(1, | ||
| + | print func_info(True)(add)(1, | ||
| + | </ | ||
| ===== 参考文献 ===== | ===== 参考文献 ===== | ||
| - | < | + | |< |
| - | <iframe src="http://rcm-jp.amazon.co.jp/ | + | <a target="_blank" |
| - | </ | + | </ |
| + | < | ||
| + | </ | ||
| [[http:// | [[http:// | ||