zipimport

源代码： Lib/zipimport.py

此模块添加了从 ZIP 格式档案中导入 Python 模块（ *.py ， *.pyc ）和包的能力。通常不需要明确地使用 zipimport 模块，内置的 import 机制会自动将此模块用于 ZIP 档案路径的 sys.path 项目上。

通常， sys.path 是字符串的目录名称列表。此模块同样允许 sys.path 的一项成为命名 ZIP 文件档案的字符串。 ZIP 档案可以容纳子目录结构去支持包的导入，并且可以将归档文件中的路径指定为仅从子目录导入。比如说，路径 example.zip/lib/ 将只会从档案中的 lib/ 子目录导入。

任何文件都可以放到 ZIP 档案中，但只有 .py 和 .pyc 文件会触发导入器操作。 动态模块 (.pyd, .so) 的 ZIP 导入是不被允许的。 请注意如果一个档案只包含有 .py 文件，那么 Python 将不会尝试通过添加对应的 .pyc 文件来修改档案，这意味着如果一个 ZIP 档案不包含 .pyc 文件，则导入速度可能会相当慢。

在 3.8 版本发生变更: 以前，不支持带有档案注释的 ZIP 档案。

参见

Phil Katz 编写的 ZIP 文件格式文档，此格式和使用的算法的创建者。

由 James C. Ahlstrom 编写，他也提供了实现。 Python 2.3 遵循 PEP 273 的规范，但是使用 Just van Rossum 编写的使用了 PEP 302 中描述的导入钩的实现。

为所有导入器的实现提供相关协议的包。

此模块定义了一个异常：

异常由 zipimporter 对象引发。这是 ImportError 的子类，因此，也可以捕获为 ImportError 。

zipimporter 是用于导入 ZIP 文件的类。

创建新的 zipimporter 实例。 archivepath 必须是指向 ZIP 文件的路径，或者 ZIP 文件中的特定路径。例如， foo/bar.zip/lib 的 archivepath 将在 ZIP 文件 foo/bar.zip 中的 lib 目录中查找模块（只要它存在）。

如果 archivepath 没有指向一个有效的 ZIP 档案，引发 ZipImportError 。

在 3.12 版本发生变更: Methods find_loader() and find_module(), deprecated in 3.10 are now removed. Use find_spec() instead.

返回 None 来显式地请求默认语义的 importlib.abc.Loader.create_module() 实现。

在 3.10 版本加入.

importlib.abc.Loader.exec_module() 的实现。

在 3.10 版本加入.

importlib.abc.PathEntryFinder.find_spec() 的实现。

在 3.10 版本加入.

返回指定模块的代码对象。 如果模块无法被导入则引发 ZipImportError。

返回与 pathname 相关联的数据。如果不能找到文件则引发 OSError 错误。

在 3.3 版本发生变更: 曾经是 IOError 被引发而不是 OSError 。

返回如果指定模块被导入则应当要设置的 __file__ 值。 如果模块无法被导入则引发 ZipImportError。

在 3.1 版本加入.

返回指定模块的源代码。如果没有找到模块则引发 ZipImportError ，如果档案包含模块但是没有源代码，返回 None 。

如果由 fullname 指定的模块是一个包则返回 True 。如果不能找到模块则引发 ZipImportError 错误。

导入由 fullname 所指定的模块。 fullname 必须为（带点号的）完整限定名称。 成功时返回导入的模块，失败时引发 ZipImportError。

自 3.10 版本弃用: 使用 exec_module() 来代替。

清除在 ZIP 归档文件中找到的相关文件信息的内部缓存。

在 3.10 版本加入.

导入器关联的 ZIP 文件的文件名，没有可能的子路径。

ZIP 文件中搜索的模块的子路径。这是一个指向 ZIP 文件根目录的 zipimporter 对象的空字符串。

当与斜杠结合使用时， archive 和 prefix 属性等价于赋予 zipimporter 构造器的原始 archivepath 参数。

这是一个从 ZIP 档案中导入模块的例子 - 请注意 zipimport 模块不需要明确地使用。