31.3。 imputil —インポートユーティリティ
バージョン2.6以降非推奨: imputil モジュールはPython3で削除されました。
このモジュールは、カスタム import フックに非常に便利で便利なメカニズムを提供します。 古いihooks
モジュールと比較して、 imputil は、カスタム import 関数に対して劇的に単純でより直接的なアプローチを採用しています。
- class imputil.ImportManager([fs_imp])
インポートプロセスを管理します。
- install([namespace])
このImportManagerを指定された名前空間にインストールします。
- uninstall()
以前のインポートメカニズムを復元します。
- add_suffix(suffix, importFunc)
文書化されていません。
- class imputil.Importer
標準のインポート関数を置き換えるための基本クラス。
- import_top(name)
トップレベルモジュールをインポートします。
- get_code(parent, modname, fqname)
指定されたモジュールのコードを見つけて取得します。
parent は、インポートするコンテキストを定義する親モジュールを指定します。
None
の場合があり、検索の特定のコンテキストがないことを示します。modname は、親内の単一のモジュール(点線ではない)を指定します。
fqname は、完全修飾モジュール名を指定します。 これは、モジュール名前空間の「ルート」からmodnameまでの(潜在的に)点線の名前です。
親がない場合は、modname == fqnameです。
このメソッドは、
None
または3タプルを返す必要があります。モジュールが見つからなかった場合は、
None
が返されます。2タプルまたは3タプルの最初の項目は、見つかったモジュールがパッケージであるかどうかを指定する整数0または1である必要があります。
2番目の項目は、モジュールのコードオブジェクトです(新しいモジュールの名前空間内で実行されます)。 このアイテムは、完全にロードされたモジュールオブジェクトにすることもできます(例: 共有ライブラリからロードされます)。
3番目の項目は、コードオブジェクトが実行される前に新しいモジュールに挿入される名前/値ペアのディクショナリです。 これは、モジュールのコードが特定の値(モジュールが見つかった場所など)を予期している場合に提供されます。 2番目の項目がモジュールオブジェクトの場合、これらの名前/値は、モジュールがロード/初期化された後に挿入されます。
- class imputil.BuiltinImporter
- 組み込みモジュールとフリーズモジュールのインポートメカニズムをエミュレートします。 これは、 Importer クラスのサブクラスです。
- get_code(parent, modname, fqname)
- 文書化されていません。
- imputil.py_suffix_importer(filename, finfo, fqname)
- 文書化されていません。
- class imputil.DynLoadSuffixImporter([desc])
- 文書化されていません。
- import_file(filename, finfo, fqname)
- 文書化されていません。
31.3.1。 例
これは、階層モジュールインポートの再実装です。
このコードは、実行されるのではなく、読み取ることを目的としています。 ただし、それは機能します。これを有効にするために必要なのは、「インポートニー」だけです。
(名前は、このモジュールの前身である「ni」の駄洒落です。)
その他の例については、importers
モジュール(PythonソースディストリビューションのDemo/imputil/
にあります)も参照してください。