【Python】 __init__.py ファイルの意味を解説

この記事では、 Python の __init__.py ファイルの意味を解説します。

私自身、元々は Java や JavaScript からプログラミング経験が始まり、Python の経験は直近数年です。

他のプログラミング言語を経験してきた方々にとって、Pythonには少し変わった概念がいくつかありますよね。

今日は、その中でも特に興味深い __init__.py ファイルについて見ていきましょう。

※この記事では、ある程度かいつまんで紹介しています。パッケージや名前空間などについての基本概念は割愛します。

__init__.py とは何か？

__init__.py は、Pythonのパッケージシステムにおいて重要な役割を果たす特別なファイルです。

簡単に言えば、このファイルはディレクトリを Python パッケージとして扱うよう Python に指示します。

他の言語では見られないこの概念は、最初は違和感を覚えるかもしれません。

この __init__.py がなくても簡単なプログラムだと動作しますし、 __init__.py には何も書かないことも多いですからね。

なぜ __init__.py が必要なのか？

まず、先述の通り、「パッケージの定義」 として機能します。

__init__.py ファイルが存在することで、そのディレクトリがただのフォルダではなく、 Python パッケージであることを示します。

また、 __init__.py には何も書かないことも多いですが、「初期化コード」 として、パッケージがインポートされたときに実行したいコードをここに書くことができます。

類似の概念として、パッケージ内のモジュールやサブパッケージをどのように公開するかを制御する、「名前空間の管理」も行えます。

__init__.py の基本的な使い方

1. 空のファイル

最もシンプルな使い方は、ただ空の __init__.py ファイルを作成することです。

my_package/
    __init__.py
    module1.py
    module2.py

これだけで、my_package は Python パッケージとして認識されます。

2. パッケージレベルの変数や関数の定義

# __init__.py
package_variable = "this is a package-level variable"

def package_function():
    return "this is a package-level function"

これらは my_package.package_variable や my_package.package_function() としてアクセスできます。

3. サブモジュールのインポート

# __init__.py
from .module1 import function1
from .module2 import function2

これにより、my_package.function1() や my_package.function2() として直接使用できるようになります。

おわりに

__init__.py は、一見奇妙に見えるかもしれませんが、Pythonのモジュールシステムを柔軟かつ強力にする重要な要素です。

他の言語にない概念ですが、Pythonのコードを構造化し、管理しやすくするのに役立ちます。

新しい言語を学ぶ際は、その言語の癖さえ理解できれば、あとは同じだと思えば素早くキャッチアップできますね。