【Python】特定のパッケージからインポートされたモジュールを確認する方法

sys.modulesを使ってインポート済みモジュールを一覧表示する

アプリケーション内で、ある特定のパッケージに属するPythonモジュールがどれだけ使われているかを把握したい場面は少なくありません。そんなときに役立つのが、標準ライブラリのsysモジュールが提供するsys.modulesです。

sys.modulesは、これまでに読み込まれた（インポートされた）すべてのモジュール名をキー、対応するモジュールオブジェクトを値として格納した辞書です。この辞書のキーを調べることで、現時点でインポートされている全モジュールを簡単に確認できます。

基本的な使い方

以下は、sys.modules.keys()を使ってインポート済みモジュールの一覧を表示する例です。

>>> from datetime import datetime
>>> import sys
>>> print(sys.modules.keys())
dict_keys(['copy_reg', 'sre_compile', 'locale', '_sre', 'functools', 'encodings', 'site', 'datetime', 'operator', '__main__', 'types', 'abc', '_weakrefset', 'errno', 'backports', 're', 'ntpath', '_codecs', 'zope', 'nt', '_warnings', 'genericpath', 'stat', 'zipimport', 'mpl_toolkits', 'warnings', 'sys', 'codecs', 'os.path', '_functools', 'signal', 'traceback', 'linecache', 'os', '_weakref'])

このように、Pythonインタプリタが起動時に自動的に読み込む標準モジュールに加えて、自分でインポートしたdatetimeなども含めた一覧が取得できます。

特定のパッケージに属するモジュールだけを抽出する

目的のパッケージに関連するモジュールのみを知りたい場合は、リスト内包表記とstartswith()を組み合わせてフィルタリングすると便利です。

>>> import sys
>>> package_modules = [name for name in sys.modules if name.startswith('encodings')]
>>> print(package_modules)
['encodings', 'encodings.encodings', 'encodings.cp437', 'encodings.codecs', 'encodings.__builtin__', 'encodings.cp1252', 'encodings.aliases']

この方法なら、サブモジュールも含めて「encodings」パッケージ関連のモジュールだけを効率よく取り出せます。

python -v オプションでインポートの過程を追跡する

もうひとつの手軽な方法として、-v（verbose）オプションを付けてPythonを実行すると、モジュールがインポートされるたびにその詳細メッセージが出力されます。どのファイルからどのモジュールが読み込まれたかを順番に確認できるため、デバッグや依存関係の調査に役立ちます。

たとえば、hello.pyというスクリプトのインポート状況を調べるには、次のように実行します。

$ python -v hello.py

標準エラー出力に、各モジュールの検索・読み込み過程が逐一表示されます。

まとめ

• sys.modulesはインポート済みモジュール名をキーとする辞書で、keys()で一覧を取得できる。
• startswith()などでフィルタリングすれば、特定パッケージ関連のモジュールだけを抽出できる。
• python -vオプションを使うと、インポートの過程を詳細に追跡できる。

用途に応じてこれらの方法を使い分けることで、アプリケーションの依存モジュールを効率的に把握できます。