【Python】関数名を格納した文字列からモジュールの関数を動的に呼び出す方法

Pythonでは、オブジェクトが持つインスタンス変数やメソッドはすべて「属性」として扱われます。そのため、関数名を格納した文字列からモジュール内の関数を呼び出すには、まず該当する属性を取得し、そこに紐づいている関数オブジェクトを実行するという流れになります。

getattr() を使った基本的な呼び出し方

文字列から関数を呼び出す際に最も推奨されるのが、組み込み関数の getattr() を使う方法です。例えば、foo というモジュールに bar という関数が定義されており、その関数名が文字列 "bar" として変数に格納されているケースを考えてみましょう。foo.bar() を呼び出すベストプラクティスは以下の通りです。

>>> import foo
>>> method_to_call = getattr(foo, 'bar')
>>> result = method_to_call()

getattr(オブジェクト, 属性名) の形式で指定することで、文字列で与えられた名前に対応する関数オブジェクトを取得できます。取得したオブジェクトは通常の関数と同じように () を付けて実行可能です。

なお、属性が存在しない可能性がある場合は、getattr(foo, 'bar', None) のように第3引数にデフォルト値を指定しておくと、エラーを回避して安全に処理を進められます。

globals() / locals() を使う方法

モジュールのプレフィックスなしで、グローバル名前空間やローカル名前空間に直接定義されている関数を呼び出したい場合は、globals() や locals() を利用する方法もあります。

• locals(): 現在のローカルシンボルテーブルを辞書形式で返します
• globals(): グローバルシンボルテーブルを辞書形式で返します

これらの辞書に対して、関数名をキーとしてアクセスすれば、目的の関数オブジェクトを取り出せます。

記述例

>>> result = locals()["myfunction"]()

または

>>> result = globals()["myfunction"]()

注意点：eval() の使用は避けよう

文字列からコードを実行する手段として eval() を使う例も見かけますが、これは任意のコードが実行される危険性があり、セキュリティ上のリスクが高いため推奨されません。動的に関数を呼び出す場合は、getattr() や globals()/locals() を使う方法が安全かつ可読性にも優れています。

まとめ

• モジュール内の関数を文字列から呼び出すなら getattr() が第一候補
• 名前空間直下の関数なら globals() や locals() の辞書経由で取得可能
• 存在しない属性への対策として getattr() のデフォルト値引数を活用する
• eval() による実行はセキュリティリスクがあるため避ける