31.3. imputil —导入 Util
自 2.6 版起弃用:imputil模块已在 Python 3 中删除。
此模块为自定义import钩子提供了非常方便实用的机制。与较早的ihooks
模块相比,imputil对自定义import函数采用了一种非常简单且直接的方法。
-
- class *
imputil.
ImportManager
([* fs_imp *])
- Management 导入过程。
- class *
-
install
([名称空间])- 将此 ImportManager 安装到指定的名称空间中。
-
uninstall
( )- 恢复以前的导入机制。
-
add_suffix
(后缀,* importFunc *)- Undocumented.
-
类别
imputil.
Importer
- 用于替换标准导入Function的 Base Class。
-
import_top
(* name *)- 导入顶级模块。
-
get_code
(* parent , modname , fqname *)- 查找并检索给定模块的代码。
-
parent *指定一个父模块来定义要导入的上下文。它可能是
None
,表示没有特定的搜索上下文。 -
modname *指定父模块中的单个模块(不带点)。
-
fqname *指定标准模块名称。这是一个(可能)点缀的名称,从模块名称空间的“根”到 modname。
如果没有父代,则为 modname == fqname。
此方法应返回None
或 3 个 Tuples。
Note
-
如果找不到该模块,则应返回
None
。 -
2 或 3Tuples 的第一项应为整数 0 或 1,指定找到的模块是否为包装。
-
第二项是模块的代码对象(它将在新模块的名称空间内执行)。该项目也可以是完全加载的模块对象(例如,从共享库加载)。
-
第三项是名称/值对的字典,将在执行代码对象之前将其插入新模块。如果模块的代码需要某些值(例如找到模块的位置),则提供此选项。当第二项是模块对象时,在模块被加载/初始化之后,将插入这些名称/值。
-
类别
imputil.
BuiltinImporter
- 模拟内置和冻结模块的导入机制。这是Importer类的子类。
-
get_code
(* parent , modname , fqname *)- Undocumented.
-
imputil.
py_suffix_importer
(* filename , finfo , fqname *)- Undocumented.
-
- class *
imputil.
DynLoadSuffixImporter
([* desc *])
- Undocumented.
- class *
-
import_file
(* filename , finfo , fqname *)- Undocumented.
31.3.1. Examples
这是分层模块导入的重新实现。
该代码仅供阅读,不执行。但是,它确实有效–要启用它,您需要做的就是“导入膝盖”。
(名称是该模块的前身“ 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/
中找到)。