Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】staticmethod::__wrapped__定数の使い方

__wrapped__定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__wrapped__定数は、デコレータによってラップされた関数やメソッドなどのオブジェクトにおいて、その元の、ラップされる前のオブジェクトへの参照を保持する定数です。Pythonのデコレータは、既存の関数やクラスに機能を追加する強力な手段ですが、デコレートすることで元のオブジェクトのメタデータ(例えば、関数名、ドキュメンテーション文字列、引数のシグネチャなど)が失われることがあります。この問題を解決するために、functoolsモジュールのwrapsデコレータなどが__wrapped__を利用します。wrapsデコレータは、元のオブジェクトを__wrapped__属性に設定し、同時に他のメタデータもコピーします。これにより、デコレートされたオブジェクトからでも、__wrapped__を通じて元のオブジェクトの情報を透過的に取得できるようになり、デバッグツールの動作や、ドキュメンテーション生成の際に元の情報を正しく表示できます。staticmethodのような関数をクラスメソッドとして扱う特殊なデコレータが、さらに別のデコレータでラップされるような複雑な状況下でも、この__wrapped__は元の関数へのアクセスパスとして機能し、デコレータの多重適用時における情報の喪失を防ぐ上で重要な役割を果たします。

構文(syntax)

1import functools
2
3def my_decorator(func):
4    @functools.wraps(func)
5    def wrapper(*args, **kwargs):
6        return func(*args, **kwargs)
7    return wrapper
8
9@my_decorator
10def my_function():
11    return "This is the original function."
12
13original_function = my_function.__wrapped__

引数(parameters)

引数なし

引数はありません

戻り値(return)

Callable

__wrapped__は、メソッドをラップしている元の関数やメソッドを表す callable オブジェクトを返します。

関連コンテンツ