zipimport --- 从 Zip 归档导入模块¶
源代码： Lib/zipimport.py
This module adds the ability to import Python modules (*.py,
*.pyc) and packages from ZIP-format archives. It is usually not
needed to use the zipimport module explicitly; it is automatically used
by the built-in import mechanism for sys.path items that are paths
to ZIP archives.
通常， sys.path 是字符串的目录名称列表。此模块同样允许 sys.path 的一项成为命名 ZIP 文件档案的字符串。 ZIP 档案可以容纳子目录结构去支持包的导入，并且可以将归档文件中的路径指定为仅从子目录导入。比如说，路径 example.zip/lib/ 将只会从档案中的 lib/ 子目录导入。
任何文件都可以放到 ZIP 档案中，但只有 .py 和 .pyc 文件会触发导入器操作。 动态模块 (.pyd, .so) 的 ZIP 导入是不被允许的。 请注意如果一个档案只包含有 .py 文件，那么 Python 将不会尝试通过添加对应的 .pyc 文件来修改档案，这意味着如果一个 ZIP 档案不包含 .pyc 文件，则导入速度可能会相当慢。
在 3.13 版本发生变更: 已支持 ZIP64
在 3.8 版本发生变更: 以前，不支持带有档案注释的 ZIP 档案。
参见
- PKZIP Application Note
Phil Katz 编写的 ZIP 文件格式文档，此格式和使用的算法的创建者。
- PEP 273 - 从ZIP压缩包导入模块
由 James C. Ahlstrom 编写，他也提供了实现。 Python 2.3 遵循 PEP 273 的规范，但是使用 Just van Rossum 编写的使用了 PEP 302 中描述的导入钩的实现。
importlib- 导入机制的实现为所有导入器的实现提供相关协议的包。
此模块定义了一个异常：
- exception zipimport.ZipImportError¶
异常由 zipimporter 对象引发。这是
ImportError的子类，因此，也可以捕获为ImportError。
zipimporter 对象¶
zipimporter 是用于导入 ZIP 文件的类。
- class zipimport.zipimporter(archivepath)¶
创建新的 zipimporter 实例。 archivepath 必须是指向 ZIP 文件的路径，或者 ZIP 文件中的特定路径。例如，
foo/bar.zip/lib的 archivepath 将在 ZIP 文件foo/bar.zip中的lib目录中查找模块（只要它存在）。如果 archivepath 没有指向一个有效的 ZIP 档案，引发
ZipImportError。在 3.12 版本发生变更: 在 3.10 中已弃用的
find_loader()和find_module()方法现在已被移除。 请改用find_spec()。- create_module(spec)¶
返回
None来显式地请求默认语义的importlib.abc.Loader.create_module()实现。Added in version 3.10.
- exec_module(module)¶
importlib.abc.Loader.exec_module()的实现。Added in version 3.10.
- find_spec(fullname, target=None)¶
importlib.abc.PathEntryFinder.find_spec()的实现。Added in version 3.10.
- get_code(fullname)¶
返回指定模块的代码对象。 如果模块无法被导入则引发
ZipImportError。
- get_filename(fullname)¶
返回如果指定模块被导入则应当要设置的
__file__值。 如果模块无法被导入则引发ZipImportError。Added in version 3.1.
- get_source(fullname)¶
返回指定模块的源代码。如果没有找到模块则引发
ZipImportError，如果档案包含模块但是没有源代码，返回None。
- is_package(fullname)¶
如果由 fullname 指定的模块是一个包则返回
True。如果不能找到模块则引发ZipImportError错误。
- load_module(fullname)¶
导入由 fullname 所指定的模块。 fullname 必须为（带点号的）完整限定名称。 成功时返回导入的模块，失败时引发
ZipImportError。从 3.10 版起已弃用，将在 3.15 版中移除: 使用
exec_module()来代替。
- invalidate_caches()¶
清除在 ZIP 归档文件中找到的相关文件信息的内部缓存。
Added in version 3.10.
- archive¶
导入器关联的 ZIP 文件的文件名，没有可能的子路径。
- prefix¶
ZIP 文件中搜索的模块的子路径。这是一个指向 ZIP 文件根目录的 zipimporter 对象的空字符串。
当与斜杠结合使用时，
archive和prefix属性等价于赋予zipimporter构造器的原始 archivepath 参数。
例子¶
Here is an example that imports a module from a ZIP archive - note that the
zipimport module is not explicitly used.
$ unzip -l example_archive.zip
Archive: example_archive.zip
Length Date Time Name
-------- ---- ---- ----
8467 01-01-00 12:30 example.py
-------- -------
8467 1 file
>>> import sys
>>> # 将归档添加到模块搜索路径的最前面
>>> sys.path.insert(0, 'example_archive.zip')
>>> import example
>>> example.__file__
'example_archive.zip/example.py'