Pythonのパッケージ拡張ユーティリティ

特定のパッケージのモジュール検索パスに追加して、パッケージに含まれるリソースを操作する場合は、Pythonライブラリのpkgutilモジュールを使用する必要があります。 Pythonパッケージのインポートルールを変更するための関数が含まれています。パッケージ内に分散されたファイルから非コードリソースをロードすることも可能です。

extend_path（path、name）

パッケージを構成するモジュールの検索パスを拡張します。使用目的は、次のコードをパッケージの__init__。py

import pkgutil
__path__ = pkgutil.extend_path(__path__, __name__)

extend_path（）は、sys.pathをスキャンして、2番目の引数として指定されたパッケージにちなんで名付けられたサブディレクトリを含むディレクトリを探します。ディレクトリのリストは、最初の引数として渡されたパス値と組み合わされ、パッケージのインポートパスとして使用するのに適した単一のリストとして返されます。

find_loader（fullname）： 指定されたフルネームのモジュールローダーを取得します。

get_importer（path_item）： 指定されたpath_itemのファインダーを取得します。

get_loader（module_or_name）

module_or_nameのローダ​​ーオブジェクトを取得します。

iter_importers（fullname =''）： 指定されたモジュール名のファインダーオブジェクトを生成します。

iter_modules（path =None、prefix =''）： パス上のすべてのサブモジュール、またはパスがNoneの場合は、sys.path上のすべての最上位モジュールのModuleInfoを生成します。

>>> pk = pkgutil.iter_modules()
>>> for p in pk:
   print (p[1])

walk_packages（path =None、prefix =''、onerror =None）： パス上で再帰的にすべてのモジュールのModuleInfoを生成します。パスがNoneの場合は、アクセス可能なすべてのモジュールを生成します。

import pkgutil
import sys
def explore_package(module_name):
   loader = pkgutil.get_loader(module_name)
   for sub_module in pkgutil.walk_packages([loader.filename]):
      _, sub_module_name, _ = sub_module
      qname = module_name + "." + sub_module_name
      print(qname)
      explore_package(qname)

ModuleInfo（module_finder、name、ispkg）：これは、モジュールの情報の簡単な要約を保持する名前付きタプルを返します。