18.16. uu —编码和解码 uuencode 文件

源代码： Lib/uu.py

此模块以 uuencode 格式编码和解码文件，从而允许pass仅 ASCII 的连接传输任意二进制数据。无论在哪里需要文件参数，这些方法都会接受一个类似文件的对象。为了向后兼容，还将接受包含路径名的字符串，并且将打开相应的文件以进行读取和写入。路径名'-'被理解为标准 Importing 或输出。但是，不建议使用此接口。调用者最好自己打开文件，并确保在需要时在 Windows 上为'rb'或'wb'模式。

该代码由 Lance Ellinghouse 提供，并由 Jack Jansen 修改。

uu模块定义以下Function：

• uu. encode(* in_file ， out_file * [，* name * [，* mode *]])

  • 将文件* in_file 编码为文件 out_file 。 uuencoded 文件的 Headers 指定 name 和 mode 作为解码文件结果的默认值。默认默认值分别来自 in_file *或'-'和0666。

• uu. decode(* in_file * [，* out_file * [，* mode * [，* quiet *]]])

  • 该调用对 uuencoded 文件* in_file 进行解码，并将结果存储在文件 out_file 中。如果 out_file 是路径名，如果必须创建文件，则使用 mode *设置权限位。 * out_file 和 mode *的默认值来自 uuencodeHeaders。但是，如果 Headers 中指定的文件已经存在，则会引发uu.Error。

如果 Importing 是由不正确的 uuencoder 产生的，并且 Python 可以从该错误中恢复，则decode()可能会向标准错误显示警告。将* quiet *设置为真实值会使此警告静音。

• exception uu. Error
  • Exception的子类，可以在各种情况下由uu.decode()引发，例如上述情况，但还包括格式错误的 Headers 或截断的 Importing 文件。