Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】__package__定数の使い方

__package__定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__package__定数は、Pythonのモモジュールが属しているパッケージの名前を表す定数です。Pythonでは、関連するモジュールを階層的に管理するために「パッケージ」という仕組みがあります。この定数は、現在のモジュールがどのパッケージの一部であるかを示す文字列を保持しており、例えばmy_packageというパッケージ内のmy_module.pyであれば、__package__の値は'my_package'となります。

この定数が特に重要になるのは、パッケージ内部での「相対インポート」を解決する際です。相対インポートとは、同じパッケージ内にある他のモジュールを、パッケージ名全体を指定せずにインポートする方法で、from . import another_moduleのように記述されます。Pythonはこの__package__の値を利用して、現在のモジュールがどのパッケージに属しているかを判断し、another_moduleがどこにあるべきかを正確に特定してインポート処理を行います。

ただし、すべてのモジュールで__package__がパッケージ名を持つわけではありません。例えば、あるモジュールがパッケージの一部ではなく単独で実行された場合や、Pythonインタプリタから直接実行されるトップレベルのスクリプトの場合には、__package__の値はNoneとなります。したがって、__package__はモジュールがパッケージ構造の一部としてインポートされた場合にのみ有効な値を持つと理解することが重要です。この定数を理解することで、Pythonのモジュール管理とインポートの仕組みをより深く把握することができます。

構文(syntax)

1print(__package__)

引数(parameters)

引数なし

引数はありません

戻り値(return)

Optional[str]

この定数は、現在のモジュールが属するパッケージ名を文字列で返します。パッケージに属さない場合は None を返します。

関連コンテンツ