pkgutil
pkgutil - 包扩展实用程序
2.3版本的新功能。
源代码： Lib / pkgutil.py
该模块为导入系统提供实用程序，特别是软件包支持。
pkgutil.extend_path(path, name)
扩展组成包的模块的搜索路径。预期用途是将以下代码放入包中__init__.py：
from pkgutil import extend_path
__path__ = extend_path(__path__, __name__)
这将添加到软件包的__path__所有以该软件包sys.path命名的目录的子目录上。如果要将单个逻辑包的不同部分分配为多个目录，这非常有用。
它还会查找与名称参数匹配的*.pkg文件。该功能与文件类似（请参阅模块以获取更多信息），不同之处在于它不包含以特殊字符开头的行。一个文件在面值上是可信的：除了检查重复项之外，文件中找到的所有项都被添加到路径中，而不管它们是否存在于文件系统中。（这是一个功能。）**.pthsiteimport*.pkg*.pkg
如果输入路径不是列表（如冻结包的情况那样），它将保持不变。输入路径未被修改; 将返回一个扩展副本。项目只在最后附加到副本。
假定sys.path是一个序列。的项目sys.path不属于（Unicode或8位），参照现有的目录被忽略的字符串。sys.path当用作文件名时导致错误的Unicode项可能会导致此函数引发异常（符合os.path.isdir()行为）。
class pkgutil.ImpImporter(dirname=None)
PEP 302导入器，它包装了Python的“经典”导入算法。
如果dirname是一个字符串，则会创建一个PEP 302导入器来搜索该目录。如果dirname是None，则会创建一个PEP 302导入器，用于搜索当前sys.path以及任何冻结或内置的模块。
请注意，ImpImporter目前不支持在展示位置上使用sys.meta_path。
class pkgutil.ImpLoader(fullname, file, filename, etc)
PEP 302 Loader包装了Python的“经典”导入算法。
pkgutil.find_loader(fullname)
查找PEP 302 “装载”为对象的全名。
如果fullname包含点，则路径必须是包含的包__path__。None如果无法找到或导入模块，则返回。此功能使用iter_importers()，因此受到与特定于平台的特殊导入位置（如Windows注册表）相同的限制。
pkgutil.get_importer(path_item)
检索给定path_item的PEP 302导入器。
sys.path_importer_cache如果它是由路径钩子新创建的，则返回的导入器将被缓存。
如果没有进口商，则返回基本进口机械的包装。这个包装永远不会插入到导入器缓存中（None而是插入）。
如果需要重新扫描，sys.path_hooks则可以手动清除缓存（或部分缓存）。
pkgutil.get_loader(module_or_name)
为module_or_name获取一个PEP 302 “加载器”对象。
如果模块或包装可以通过正常的进口机制进行访问，则返回该机械相关部件周围的包装。None如果无法找到或导入模块，则返回。如果已命名的模块尚未导入，则会导入其包含的包（如果有），以便建立包__path__。
此功能使用iter_importers()，因此受到与特定于平台的特殊导入位置（如Windows注册表）相同的限制。
pkgutil.iter_importers(fullname='')
产量PEP 302个进口商为给定的模块名称。
如果全名中含有“”，进口商将包含全名包，否则会为进口商sys.meta_path，sys.path和Python的‘经典’的进口机器，按照这个顺序。如果指定的模块位于包中，则该包将作为调用此函数的副作用导入。
部分支持标准导入机制用于在其他位置查找文件的非PEP 302机制（例如Windows注册表），但会在后面 进行搜索sys.path。通常情况下，这些位置在之前 被搜索到sys.path，以防止sys.path对它们进行投影。
为了在行为上产生明显的差异，必须有一个模块或软件包名称可以通过这两种sys.path非PEP 302文件系统机制之一访问。在这种情况下，仿真会找到前一个版本，而内置的导入机制会找到后者。
：以下类型的项目可以通过这种差异的影响imp.C_EXTENSION，imp.PY_SOURCE，imp.PY_COMPILED，imp.PKG_DIRECTORY。
pkgutil.iter_modules(path=None, prefix='')
路径(module_loader, name, ispkg)上的所有子模块的产量，或者，如果路径是，所有顶级模块都打开。Nonesys.path
路径应该是None要查找模块的路径或列表。
前缀是在输出上的每个模块名称的前面输出的字符串。
pkgutil.walk_packages(path=None, prefix='', onerror=None)
(module_loader, name, ispkg)所有模块在路径上递归产生，或者如果路径是None所有可访问的模块。
路径应该是None要查找模块的路径或列表。
前缀是在输出上的每个模块名称的前面输出的字符串。
请注意，此函数必须导入给定路径上的所有包（不是所有模块！），以便访问该属性以查找子模块。__path__
onerror是一个函数，如果在尝试导入程序包时发生任何异常，则会使用一个参数（正在导入的程序包的名称）调用它。如果未提供onerror函数，ImportError则会捕获并忽略这些函数，而传播所有其他异常，从而终止搜索。
例子：
# list all modules python can access
walk_packages()
# list all submodules of ctypes
walk_packages(ctypes.__path__, ctypes.__name__ + '.')
pkgutil.get_data(package, resource)
从包中获取资源。
这是PEP 302加载器get_data()API 的包装。所述包参数应该是一个包的名称，在标准模块格式（foo.bar）。所述资源参数应该是在一个相对文件名的形式，使用/作为路径分隔。父目录名称..是不允许的，也不是根目录名称（以a开头/）。
该函数返回一个二进制字符串，它是指定资源的内容。
对于位于已经导入的文件系统中的软件包，这大致相当于：
d = os.path.dirname(sys.modules[package].__file__)
data = open(os.path.join(d, resource), 'rb').read()
如果包装不能被找到或装载，或者它使用不支持的PEP 302装载机get_data()，则None返回。
2.6版本中的新功能。
