Pythonで関数名を文字列として取得する方法を解説

Pythonで関数名を文字列として取得するには？

Pythonでは、すべての関数に __name__ という特殊な属性が自動的に付与されています。この属性にアクセスすることで、関数名を文字列として簡単に取得できます。

基本的な使い方

以下の例を見てみましょう。まず、シンプルな関数を定義し、その __name__ 属性を出力します。

def some_func():
    return 0

print(some_func.__name__)

このコードを実行すると、次のような出力が得られます。

some_func

活用シーンの例

この __name__ 属性は、以下のような場面で特に役立ちます。

• デバッグやロギング： 関数の実行状況をログに記録する際、関数名を動的に取得できます。
• デコレータの作成： デコレータ内で元の関数名を参照したり、ラップした関数のメタデータを保持したりするのに使われます。
• 動的な関数呼び出し： 文字列と関数を対応付けて、柔軟な処理を実現できます。

注意点

デコレータなどで関数をラップした場合、__name__ の値が変わってしまうことがあります。これを防ぐには、標準ライブラリの functools.wraps を使用するとよいでしょう。

from functools import wraps

def my_decorator(func):
    @wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper

@my_decorator
def some_func():
    return 0

print(some_func.__name__)  # some_func と表示される

このように、__name__ 属性を使えば、Pythonで関数名を文字列として手軽に取得することができます。