Pythonモジュールを単一ファイルにカプセル化することはできる？代替手段を徹底解説

結論：単一ファイルへのカプセル化は原則として不可能

Pythonでは、一般的にモジュールを単一のファイルにカプセル化（まとめる）することはできません。その理由は、Pythonがモジュールを検索する仕組みが「ファイルとディレクトリ」に基づいているためです。すべてを1つのファイルに統合してしまうと、このモジュール検索の仕組み自体が壊れてしまいます。

しかし、権限不足などの理由でマシンにモジュールをインストールできない場合でも、いくつかの有効な代替手段があります。

代替手段①：sys.pathにディレクトリを追加する

インストール権限がない場合は、モジュールファイルを別のディレクトリに保存し、sys.pathにそのパスを追加することで、Pythonに追加の検索場所を教えることができます。

>>> import os, sys
>>> file_path = 'AdditionalModules/'
>>> sys.path.append(os.path.dirname(file_path))
>>> # PYTHONPATHに設定したため、PythonはAdditionalModulesフォルダも検索対象にします

このコードを実行すると、以降のimport文で「AdditionalModules」フォルダ内のモジュールも読み込めるようになります。手軽な方法ですが、スクリプトごとに設定が必要になる点には注意してください。

代替手段②：virtualenvで隔離されたPython環境を作る

もうひとつの有力な選択肢が、virtualenvを使ってローカルに独立したPython環境を構築する方法です。

virtualenvが解決する根本的な問題は、依存関係とバージョンの競合、そして間接的には権限の問題です。例えば、あるアプリケーションはLibFooのバージョン1を必要とし、別のアプリケーションはバージョン2を必要としている状況を想像してみてください。両方のアプリケーションをどう共存させればよいのでしょうか？

すべてのパッケージを /usr/lib/python2.7/site-packages（または各プラットフォームの標準的な場所）にインストールしてしまうと、意図せずアップグレードすべきでないアプリケーションまで更新してしまう事態に陥りがちです。

また、virtualenvは仮想環境をユーザーディレクトリ内に作成できるため、マシンへのインストール権限がない場合でも、管理者権限なしでパッケージを利用できます。まさに本記事のようなユースケースに適したソリューションです。

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

まとめ

• Pythonモジュールを単一ファイルにカプセル化することは、モジュール検索の仕組み上、原則として不可能です。
• インストール権限がない場合は、sys.path.append()でモジュール検索パスを追加するのが手軽です。
• 依存関係やバージョンの管理、権限問題の回避には、virtualenvによる仮想環境の構築が最適です。