19.10. uu —编码和解码uuencode文件¶

源代码： Lib/uu.py

---

此模块以uuencode格式编码和解码文件，允许任意二进制数据通过仅ASCII连接传输。无论在何处需要文件参数，这些方法都接受类似于文件的对象。为了向后兼容，还接受包含路径名的字符串，并且相应的文件将被打开用于读取和写入；路径名 '-' 被理解为意味着标准输入或输出。但是，此接口已弃用；它最好是调用者打开文件本身，并确保，当需要时，模式是 'rb' 或 'wb' 在Windows上。

此代码由Lance Ellinghouse贡献，并由Jack Jansen修改。

uu 模块定义以下功能：

uu.encode(in_file, out_file, name=None, mode=None)¶

Uuencode文件 in_file 到文件 out_file。 uuencoded文件将具有指定 name 和 mode 作为解码文件的结果的默认值的标题。默认默认值分别取自 in_file，或 '-' 和 0o666。

uu.decode(in_file, out_file=None, mode=None, quiet=False)¶

此调用解码编码文件 in_file，将结果放在文件 out_file 上。如果 out_file 是路径名，则如果必须创建文件，则 mode 用于设置权限位。 out_file 和 mode 的默认值取自uuencode头。但是，如果头中指定的文件已经存在，则会引发 uu.Error。

如果输入由不正确的uuencoder生成，并且Python可以从该错误中恢复，则 decode() 可能会向标准错误打印警告。将 quiet 设置为true值会使此警告静音。

exception uu.Error¶

Exception 的子类，这可以在各种情况下由 uu.decode() 提出，诸如如上所述，但是也包括格式错误的报头或截断的输入文件。