Pythonモジュールをインストールせずにインポートする方法を徹底解説

はじめに

権限の制約などにより、マシンにパッケージをインストールできない環境でも、Pythonモジュールをインポートして利用する方法はいくつかあります。この記事では、代表的な2つのアプローチ——sys.pathへのパス追加とvirtualenvによる仮想環境の構築——について詳しく解説します。

方法1：sys.pathにモジュールのパスを追加する

十分な管理者権限がなく、システムディレクトリへモジュールをインストールできない場合でも、モジュールファイルを任意のディレクトリ（例えばプロジェクトフォルダ内など）に保存し、その場所をPythonの検索パスに登録すれば、通常どおりimport文で読み込めるようになります。

以下のコードは、AdditionalModules/ フォルダを検索対象に追加する例です。

>>> import os, sys
>>> file_path = 'AdditionalModules/'
>>> sys.path.append(os.path.dirname(file_path))
>>> # PYTHONPATHが設定されたため、Pythonは
>>> # AdditionalModulesフォルダからもモジュールを検索できるようになりました。

このように sys.path.append() を使えば、実行時に動的に検索パスを拡張できます。ただし、この設定はスクリプトごとに必要になるため、複数のプロジェクトで共有したい場合は後述のvirtualenvの方が管理しやすくなります。

方法2：virtualenvで独立した仮想環境を作る

もうひとつの有力な選択肢が、virtualenvを使ったローカル仮想環境の構築です。仮想環境とは、特定のプロジェクト専用に隔離されたPython実行環境のことで、依存関係やバージョンの問題、そして間接的には権限の問題も解決してくれます。

仮想環境が必要な理由

典型的なシナリオを想像してみてください。あるアプリケーションはLibFooのバージョン1を必要としているのに、別のアプリケーションはバージョン2を要求している——このような場合、両方のアプリケーションをどう共存させればよいのでしょうか？

すべてのパッケージを /usr/lib/python2.7/site-packages のようなプラットフォーム標準の場所にインストールしてしまうと、意図せずアップグレードすべきでないアプリケーションのライブラリを更新してしまい、動作を壊してしまうリスクがあります。

権限がない環境での活用

virtualenvは、今回のような「権限がないためマシンにパッケージをインストールできない」というケースにも有効です。仮想環境はユーザーのホームディレクトリなど、書き込み権限のある場所に構築できるため、管理者権限なしで自由にパッケージを追加・管理できます。

virtualenvの詳細については、公式ドキュメントをご覧ください：https://virtualenv.pypa.io/en/stable/

まとめ

Pythonモジュールをインストールせずに使う方法としては、次の2つが挙げられます。

• sys.path.append()を使う方法： 手軽で即効性があるが、設定はセッションごとに必要
• virtualenvを使う方法： 環境全体を隔離でき、依存関係や権限の問題を根本的に解決できる

一時的な利用ならsys.pathへの追加で十分ですが、本格的な開発ではvirtualenvなどの仮想環境ツールを活用するのがベストプラクティスと言えます。