【Python】実行時にモジュールを自動インストールしてインポートする方法

Pythonでは、pipを使って実行時にパッケージをインストールし、importlib.import_module()を使えば、モジュール名を文字列として指定して動的にインポートできます。この2つを組み合わせると、「必要なモジュールが存在しない場合に自動的にインストールしてから読み込む」という処理が簡単に実現できます。

自動インストール付きインポートの実装例

import pip
import importlib

def import_with_auto_install(package):
    try:
        return importlib.import_module(package)
    except ImportError:
        pip.main(['install', package])
    return importlib.import_module(package)

# 使用例
if __name__ == '__main__':
    scrapy = import_with_auto_install('scrapy')
    print(scrapy)

コードの解説

このスクリプトの動作は以下の流れになります。

• まず importlib.import_module() で、指定されたモジュールのインポートを試みます。
• モジュールが見つからず ImportError が発生した場合は、pip.main(['install', package]) を呼び出して該当パッケージをインストールします。
• インストール完了後、再度 importlib.import_module() を実行してモジュールを読み込みます。

上記の例では、scrapy モジュールが環境に存在しない場合に自動的にインストールされ、インストールが完了した時点でインポートされます。

注意点：pip.main() の非推奨問題

pip.main() は pip の内部APIであり、バージョンによっては非推奨となっていたり、正しく動作しない場合があります。より堅牢にしたい場合は、subprocess モジュール経由で pip コマンドを実行する方法がおすすめです。

import subprocess
import importlib

def import_with_auto_install(package):
    try:
        return importlib.import_module(package)
    except ImportError:
        subprocess.check_call(['python', '-m', 'pip', 'install', package])
    return importlib.import_module(package)

また、本番環境や配布するアプリケーションでは、依存関係は requirements.txt や pyproject.toml で事前に管理するのが一般的です。実行時の自動インストールは、あくまで簡易スクリプトやプロトタイプ開発向けの手法として活用するとよいでしょう。