"zipimport" --- 从 Zip 存档中导入模块
*************************************

**原始碼：**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 档案。

也參考:

  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" 。

   create_module(spec)

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

      3.10 版新加入.

   exec_module(module)

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

      3.10 版新加入.

   find_loader(fullname, path=None)

      "importlib.abc.PathEntryFinder.find_loader()" 的实现。

      3.10 版後已棄用: 使用 "find_spec()" 来代替。

   find_module(fullname, path=None)

      搜索由 *fullname* 指定的模块。 *fullname* 必须是完全合格的（点分
      的）模块名。它返回 zipimporter 实例本身如果模块被找到，或者返回
      "None" 如果没找到指定模块。可选的 *path* 被忽略，这是为了与导入
      器协议兼容。

      3.10 版後已棄用: 使用 "find_spec()" 来代替。

   find_spec(fullname, target=None)

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

      3.10 版新加入.

   get_code(fullname)

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

   get_data(pathname)

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

      3.3 版更變: 曾经是 "IOError" 被引发而不是 "OSError" 。

   get_filename(fullname)

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

      3.1 版新加入.

   get_source(fullname)

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

   is_package(fullname)

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

   load_module(fullname)

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

      3.10 版後已棄用: 使用 "exec_module()" 来代替。

   invalidate_caches()

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

      3.10 版新加入.

   archive

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

   prefix

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

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


範例
====

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

   $ unzip -l example.zip
   Archive:  example.zip
     Length     Date   Time    Name
    --------    ----   ----    ----
        8467  11-26-02 22:30   jwzthreading.py
    --------                   -------
        8467                   1 file
   $ ./python
   Python 2.3 (#1, Aug 1 2003, 19:54:32)
   >>> import sys
   >>> sys.path.insert(0, 'example.zip')  # Add .zip file to front of path
   >>> import jwzthreading
   >>> jwzthreading.__file__
   'example.zip/jwzthreading.py'
