在线文档教程

imputil

imputil - 导入实用程序

自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)

无证。

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模块(可以Demo/imputil/在Python源代码发行版中找到该模块)以获取其他示例。