Skip to main content

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文件将具有指定 namemode 作为解码文件的结果的默认值的标题。默认默认值分别取自 in_file,或 '-'0o666

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

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

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

exception uu.Error

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

参见

模块 binascii

支持模块包含ASCII到二进制和二进制到ASCII转换。