Python inspect.getsource()の使い方|関数のソースコードを表示する方法とOSError・TypeErrorの対処
inspect.getsource()は、関数・クラス・メソッド・モジュールのソースコードを文字列で取り出す関数です。print(inspect.getsource(関数名)) で定義がそのまま表示されますが、len()などC言語で書かれた組み込み関数はTypeError、ファイルに保存されていないコードはOSErrorになります。
この記事では、getsource()の使い方と、行番号もわかるgetsourcelines()、定義されたファイルがわかるgetsourcefile()との違い、そしてソースが取れないときの原因を、実際に動かした結果つきで説明します。実行環境はPython 3.12.15です(2026年10月18日確認)。inspectモジュール全体は「Python inspectとは?オブジェクトの中身を調べる方法を解説」で紹介しています。
getsource()の基本の書き方
次の内容をsample.pyとして保存し、実行します。
import inspect
# 2倍にする関数
def double(x):
"""値を2倍にして返す"""
return x * 2
class Greeter:
def hello(self, name):
return f"こんにちは、{name}さん"
print(inspect.getsource(double))
print(inspect.getsource(Greeter.hello))
実行結果:
def double(x):
"""値を2倍にして返す"""
return x * 2
def hello(self, name):
return f"こんにちは、{name}さん"
定義の部分が、docstringも含めてそのまま文字列で返ります。最後に改行が付いているので、print()すると1行空きます。
公式ドキュメント(inspect — Python documentation、2026年10月18日確認)によると、引数にはモジュール・クラス・メソッド・関数・トレースバック・フレーム・コードオブジェクトを渡せます。ソースが取れないときはOSError、組み込みのモジュール・クラス・関数を渡したときはTypeErrorになります。
メソッドのソースはインデントが付いたまま
上の例でGreeter.helloのソースは、クラスの中のインデントが付いたまま返っています。このままast.parse()やexec()に渡すとIndentationError: unexpected indentになるので、textwrap.dedent()で先頭の空白を取り除きます。
import textwrap
src = inspect.getsource(Greeter.hello)
print(textwrap.dedent(src))
実行結果:
def hello(self, name):
return f"こんにちは、{name}さん"
getsource()の仲間の関数
| 関数 | 返すもの | 使いどころ |
|---|---|---|
getsource(obj) |
ソースコードの文字列 | 中身を表示する |
getsourcelines(obj) |
(行のリスト, 開始行番号) | 何行目に書かれているかを知る |
getsourcefile(obj) |
Pythonのソースファイルのパス(見つからなければNone) | どのファイルで定義されたかを知る |
getfile(obj) |
定義されたファイルのパス | C拡張などソースのないファイルも含めて調べる |
getcomments(obj) |
定義の直前のコメント行 | docstringのないコードの説明を拾う |
getdoc(obj) |
インデントを整えたdocstring | 説明文を表示する |
lines, start = inspect.getsourcelines(double)
print(start, len(lines))
print(inspect.getsourcefile(double).split("/")[-1])
print(repr(inspect.getcomments(double)))
実行結果:
4 3
sample.py
'# 2倍にする関数\n'
doubleはsample.pyの4行目から3行で定義されている、ということがわかります。同じ名前の関数がいくつもあって「どれが呼ばれているのか」わからないときに便利です。docstringだけ欲しいときは、余分なインデントを取り除いてくれるinspect.getdoc()を使います(Python 3.15でgetdoc()にinherit_class_doc・fallback_to_class_docという引数が追加されました。What’s New In Python 3.15、2026年10月18日確認)。
標準ライブラリやパッケージのソースを読む
getsource()がいちばん役に立つのは、ライブラリの実装をその場で読むときです。
import inspect
import json
src = inspect.getsource(json.dumps)
print(src.splitlines()[0])
print(len(inspect.getsource(json)))
実行結果:
def dumps(obj, *, skipkeys=False, ensure_ascii=True, check_circular=True,
14020
json.dumpsの定義の1行目と、jsonパッケージの__init__.py全体の文字数が取れました。ドキュメントだけではわからない既定値や動きを確かめるときに使えます。対話的に使い方だけ知りたいなら、help()のほうが手軽です(「Pythonのhelp()関数の使い方」)。
ソースコードが取得できないときの原因
TypeError:組み込み関数・組み込みクラス・組み込みモジュール
import inspect, math
for obj in (len, dict, math):
try:
inspect.getsource(obj)
except TypeError as e:
print("TypeError:", e)
実行結果:
TypeError: module, class, method, function, traceback, frame, or code object was expected, got builtin_function_or_method
TypeError: <class 'dict'> is a built-in class
TypeError: <module 'math' (built-in)> is a built-in module
len・dict・mathなどはC言語で実装されていて、Pythonのソースファイルがありません。中身を読みたい場合は、CPythonのリポジトリでC言語のソースを探すことになります。
OSError: could not get source code(ファイルに保存されていない)
getsource()は、関数が定義されたファイルを開いて該当する行を読み出しています。そのため、ファイルとして存在しないコードはソースが取れません。
import inspect
ns = {}
exec("def made(): return 1", ns)
try:
inspect.getsource(ns["made"])
except OSError as e:
print("OSError:", e)
実行結果:
OSError: could not get source code
exec()で作った関数のほか、Python 3.12の対話モード(>>>)で定義した関数でも同じエラーになりました。一方、IPython(Jupyterの土台)で定義した関数は、IPythonが入力したコードを記録しているため、IPython 9.17.1で試した範囲ではソースを取得できました。
取得できないときに備えるなら、2種類の例外をまとめて受けます。
try:
src = inspect.getsource(obj)
except (TypeError, OSError):
src = "(ソースを取得できません)"
デコレータを付けた関数では、ラッパーのソースが返ることがある
import inspect, functools
def deco(f):
@functools.wraps(f)
def wrapper(*args):
return f(*args)
return wrapper
def deco_nowraps(f):
def wrapper(*args):
return f(*args)
return wrapper
@deco
def a(): return "a"
@deco_nowraps
def b(): return "b"
print(inspect.getsource(a))
print(inspect.getsource(b))
実行結果:
@deco
def a(): return "a"
def wrapper(*args):
return f(*args)
functools.wrapsを付けたデコレータでは、元の関数(デコレータの行を含む)のソースが返ります。付けていないデコレータでは、中のwrapperのソースが返ってしまいます。理由は「Python functools.wrapsの使い方|@wrapsを付けないと起きることと__wrapped__」で説明しています。
lambda式は行全体が返る
nums = list(map(lambda n: n * 2, [1, 2])); f = lambda n: n * 3
print(repr(inspect.getsource(f)))
実行結果:
'nums = list(map(lambda n: n * 2, [1, 2])); f = lambda n: n * 3\n'
lambda式では、その式だけでなく、書かれている行全体が返ります。
使うときの注意
- ファイルを読み込むので、ループの中で何度も呼ぶ使い方には向きません
- プログラムの実行中にソースファイルを書き換えると、書き換え後の内容がずれて返ることがあります
- 返るのはファイルに書かれた文字列です。実行中に変更された動きまでは反映されません
よくある質問
Q. Pythonで関数のソースコードを表示するには?
import inspect をしてから print(inspect.getsource(関数名)) と書きます。関数名にはかっこを付けず、関数そのものを渡します。
Q. inspect.getsource()でOSError: could not get source codeが出ます。
関数がファイルに保存されていないためです。exec() で作った関数や、標準の対話モードで定義した関数で起きます。ファイルに保存したスクリプトで定義すれば取得できます。
Q. len()やprint()のソースが見られないのはなぜですか?
C言語で実装された組み込み関数で、Pythonのソースファイルがないためです。getsource() に渡すと TypeError になります。
Q. getsource()とgetsourcelines()の違いは?
getsource() はソースを1つの文字列で返し、getsourcelines() は行のリストと開始行番号の組を返します。何行目に書かれているかを知りたいときは getsourcelines() を使います。
まとめ
inspect.getsource(obj)で関数・クラス・メソッド・モジュールのソースを文字列で取得- 行番号は
getsourcelines()、ファイルはgetsourcefile() - メソッドのソースは
textwrap.dedent()でインデントを外す - 組み込み関数はTypeError、ファイルにないコードはOSError
- デコレータは
functools.wrapsがないとラッパーのソースが返る
ライブラリのソースを読む習慣は、エラーの原因を自分で突き止める力につながります。テックジムは永田町の東京本校などに通って学ぶ対面型のプログラミングスクールで、自分のペースで課題を進め、分からないところはトレーナーに質問できます。まずは無料Python講座(ゼロからはじめるPython入門講座)から試すこともできます。




