フレームオブジェクトは関数呼び出しの実行コンテキストを表し、コールスタックの情報を保持しています。デバッグやトレースに活用できます。
フレームの取得
import sys def inner(): frame = sys._getframe() print(f"Current function: {frame.f_code.co_name}") print(f"Caller: {frame.f_back.f_code.co_name}") def outer(): inner() outer()
sys._getframe() で現在のフレームを取得し、f_back で呼び出し元のフレームを辿れます。
フレームの主要属性
| f_code | コードオブジェクト |
| f_locals | ローカル変数の辞書 |
| f_globals | グローバル変数の辞書 |
| f_back | 呼び出し元のフレーム |
| f_lineno | 現在実行中の行番号 |
| f_lasti | 最後に実行したバイトコードのインデックス |
コールスタックの走査
import sys def print_stack(): frame = sys._getframe() while frame: code = frame.f_code print(f"{code.co_filename}:{frame.f_lineno} in {code.co_name}") frame = frame.f_back def func_a(): func_b() def func_b(): print_stack() func_a()
ローカル変数の取得
def debug_locals(): x = 10 y = 20 frame = sys._getframe() print(frame.f_locals) # {'x': 10, 'y': 20, 'frame': ...} debug_locals()
inspect モジュールとの連携
import inspect def show_callers(): for frame_info in inspect.stack(): print(f"{frame_info.function} at line {frame_info.lineno}") def example(): show_callers() example()
inspect.stack() は FrameInfo オブジェクトのリストを返し、より安全にスタック情報を取得できます。
注意点
フレームへの参照を保持すると循環参照が発生しやすい
sys._getframe() は CPython 固有で、他の実装では動作しない可能性がある
本番コードでの使用は避け、デバッグ用途に留める
フレームオブジェクトの理解は、デバッガーやプロファイラの実装、例外トレースバックの解析に不可欠です。
