Pythonのパッケージとは？__init__.pyによる構造と使い方を徹底解説

Pythonにおけるパッケージとは、モジュールやサブパッケージ、さらにその配下のサブサブパッケージなどで構成される、単一のPythonアプリケーション環境を定義するための階層的なファイルディレクトリ構造のことです。パッケージを活用することで、大規模なプログラムを整理された形で管理できるようになります。

パッケージの基本的な構成例

ここでは、Phoneディレクトリ内に配置されたPots.pyファイルを例に考えてみましょう。このファイルには、以下のようなソースコードが含まれています。

#!/usr/bin/python
def Pots():
    print "I'm Pots Phone"

同じ要領で、それぞれ異なる関数を持つ2つのファイルも用意します。

• Phone/Isdn.py：Isdn()関数を含むファイル
• Phone/G3.py：G3()関数を含むファイル

__init__.pyの役割と作成方法

次に、Phoneディレクトリ内にもう1つ__init__.pyというファイルを作成します。

• Phone/__init__.py

Phoneパッケージをインポートしたときにすべての関数を利用できるようにするには、__init__.py内に明示的なimport文を記述する必要があります。

from Pots import Pots
from Isdn import Isdn
from G3 import G3

これらの行を__init__.pyに追加することで、Phoneパッケージをインポートした時点で、すべての関数やクラスが利用可能になります。

パッケージのインポートと実行結果

作成したパッケージは、以下のようにしてインポートして使用します。

#!/usr/bin/python
# Now import your Phone Package.
import Phone
Phone.Pots()
Phone.Isdn()
Phone.G3()

上記のコードを実行すると、次のような結果が出力されます。

I'm Pots Phone
I'm 3G Phone
I'm ISDN Phone

パッケージ設計のポイント

上記の例では、各ファイルに1つの関数だけを定義しましたが、実際には1つのファイルに複数の関数をまとめて定義することもできます。さらに、これらのファイルの中で異なるPythonクラスを定義し、そのクラス群をもとにパッケージを構築することも可能です。

なお、本記事のコード例はPython 2系の記述スタイル（print文）を使用しています。Python 3以降ではprint("文字列")のように関数形式で記述する必要があるため、実行環境に合わせて適宜書き換えてください。