31.3. imputil —インポートユーティリティ—Pythonドキュメント

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」の駄洒落です。）

import sys, imp, __builtin__

# Replacement for __import__()
def import_hook(name, globals=None, locals=None, fromlist=None):
    parent = determine_parent(globals)
    q, tail = find_head_package(parent, name)
    m = load_tail(q, tail)
    if not fromlist:
        return q
    if hasattr(m, "__path__"):
        ensure_fromlist(m, fromlist)
    return m

def determine_parent(globals):
    if not globals or  not globals.has_key("__name__"):
        return None
    pname = globals['__name__']
    if globals.has_key("__path__"):
        parent = sys.modules[pname]
        assert globals is parent.__dict__
        return parent
    if '.' in pname:
        i = pname.rfind('.')
        pname = pname[:i]
        parent = sys.modules[pname]
        assert parent.__name__ == pname
        return parent
    return None

def find_head_package(parent, name):
    if '.' in name:
        i = name.find('.')
        head = name[:i]
        tail = name[i+1:]
    else:
        head = name
        tail = ""
    if parent:
        qname = "%s.%s" % (parent.__name__, head)
    else:
        qname = head
    q = import_module(head, qname, parent)
    if q: return q, tail
    if parent:
        qname = head
        parent = None
        q = import_module(head, qname, parent)
        if q: return q, tail
    raise ImportError("No module named " + qname)

def load_tail(q, tail):
    m = q
    while tail:
        i = tail.find('.')
        if i < 0: i = len(tail)
        head, tail = tail[:i], tail[i+1:]
        mname = "%s.%s" % (m.__name__, head)
        m = import_module(head, mname, m)
        if not m:
            raise ImportError("No module named " + mname)
    return m

def ensure_fromlist(m, fromlist, recursive=0):
    for sub in fromlist:
        if sub == "*":
            if not recursive:
                try:
                    all = m.__all__
                except AttributeError:
                    pass
                else:
                    ensure_fromlist(m, all, 1)
            continue
        if sub != "*" and not hasattr(m, sub):
            subname = "%s.%s" % (m.__name__, sub)
            submod = import_module(sub, subname, m)
            if not submod:
                raise ImportError("No module named " + subname)

def import_module(partname, fqname, parent):
    try:
        return sys.modules[fqname]
    except KeyError:
        pass
    try:
        fp, pathname, stuff = imp.find_module(partname,
                                              parent and parent.__path__)
    except ImportError:
        return None
    try:
        m = imp.load_module(fqname, fp, pathname, stuff)
    finally:
        if fp: fp.close()
    if parent:
        setattr(parent, partname, m)
    return m


# Replacement for reload()
def reload_hook(module):
    name = module.__name__
    if '.' not in name:
        return import_module(name, name, None)
    i = name.rfind('.')
    pname = name[:i]
    parent = sys.modules[pname]
    return import_module(name[i+1:], name, parent)


# Save the original hooks
original_import = __builtin__.__import__
original_reload = __builtin__.reload

# Now install our hooks
__builtin__.__import__ = import_hook
__builtin__.reload = reload_hook

その他の例については、importersモジュール（PythonソースディストリビューションのDemo/imputil/にあります）も参照してください。