31.3. 不利用 — 导入实用程序

自 2.6 版起已弃用：imputil 模块已在 Python 3 中删除。

这个模块为自定义 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，指定找到的模块是否是包。

第二项是模块的代码对象（它将在新模块的命名空间内执行）。这个项目也可以是一个完全加载的模块对象（例如从共享库加载）。

第三项是名称/值对的字典，将在代码对象执行之前插入到新模块中。这是在模块的代码需要某些值（例如找到模块的位置）的情况下提供的。当第二项是模块对象时，这些名称/值将在 模块加载/初始化之后插入 。

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/ 中找到）。

31.3. imputil — 导入实用程序 — Python 文档

31.3. 不利用 — 导入实用程序

31.3.1. 例子