第24章. モジュール・パッケージ
この作品はAIを使って翻訳されている。ご意見、ご感想をお待ちしている:translation-feedback@oreilly.com
これまで、モジュールをインポートするときはファイルを読み込んできた。これは典型的なモジュールの使い方で、特にPythonを始めて間もないころは、ほとんどのインポートで使うテクニックだろう。しかし、モジュールのインポートの話はここまでで暗示されているよりも豊かである。この章ではモジュールパッケージ、つまり通常デバイス上のフォルダ(ディレクトリ)に対応するモジュールファイルのコレクションを紹介する。この章では4つのトピックを取り上げる:
ファイルにつながるフォルダパスの一部を与えるパッケージのインポート。
モジュールをフォルダーバンドルにまとめる。
パッケージ内のドットを使用して検索を制限するパッケージ相対インポート。
名前空間パッケージ。複数のフォルダにまたがるパッケージを構築する。
これから発見するように、package importはコンピュータ上のフォルダを、そのフォルダが含むモジュールファイルやサブフォルダに対応する属性を持つ、別のPython名前空間に変える。また、同じ名前の複数のプログラミングファイルがデバイスにインストールされている場合、パッケージのインポートが名前付けの曖昧さを解決するために必要になることもある。
パッケージはやや高度なトピックであり、多くの読者はファイルベースのモジュールの経験を積むまで先延ばしにすることができる。とはいえ、パッケージはコードのファイルを組織化する簡単な方法を提供し、同名ファイルの衝突を避け、標準ライブラリやサードパーティのツールの多くで採用されている。Pythonの多くと同様、パッケージも時間の経過とともに複雑になってきているが、その使い方の基本的な知識はほとんどのPython学習者にとって有益である。
パッケージを使う
パッケージフォルダ内のアイテムをロードするには、すでに紹介した通常のインポート文とツールを使うが、ネストしたフォルダのパスを反映した名前のパスを提供する。それでは、このユーザガイド側のパッケージの話を始めよう。
パッケージ輸入
パッケージのインポートのコーディングは簡単である。インポート演算子で単純なファイル名を付けていたすべての場所で、代わりにピリオドで区切られた名前のパスを列挙することができる。例えば、import :
import dir1.dir2.mod
from :
from dir1.dir2.mod import var
そしてこれは、reload の呼び出しですでにインポートされたアイテムにも適用される:
from importlib import reload reload(dir1.dir2.mod)
これらのコンテキストにおける "ドットパス "は、 あなたのデバイス上のフォルダ階層を通り、モジュールファイルmod.py、またはベース名modを持つ他のコンポーネント(これまで見てきたように、それはバイトコードファイル、C拡張モジュール、または他のものかもしれない)につながるパスに対応すると仮定される。ここで最も重要なことは、先行するパスは、あなたのデバイス上にディレクトリdir1があり、その中にサブディレクトリdir2があり、その中にモジュールファイルmod.py(または同様のもの)があることを示している。
さらに、これらのパスは、dir1が通常のモジュール検索パスの一部である ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access