mimify

mimify — MIME processing of mail messages

自2.3版弃用：email应优先使用软件包mimify。该模块仅用于保持向后兼容性。

该mimify模块定义了两种将邮件消息转换为MIME格式和将MIME格式转换为MIME格式的功能 邮件消息可以是简单消息，也可以是所谓的多部分消息。每个部分都分开处理。如果消息中包含任何不能用7位ASCII表示的字符，则消息（部分消息）需要将消息编码为quoted-printable。Unimimifying（的一部分）消息需要撤消quoted-printable编码。在发送消息之前必须对消息进行编辑时，简化和取消消息特别有用。典型的用途是：

unmimify message
edit message
mimify message
send message

这些模块定义了以下用户可调用的函数和用户可设置的变量：

mimify.mimify(infile, outfile)

将infile中的消息复制到outfile中，在必要时将部分转换为quoted-printable并添加MIME邮件头。infile和outfile可以是文件对象（实际上是具有readline()方法（用于infile）或write()方法（用于outfile）的任何对象）或命名文件的字符串。如果infile和outfile都是字符串，它们可能具有相同的值。

mimify.unmimify(infile, outfile[, decode_base64])

将infile中的消息复制到outfile中，解码所有可引用部分。infile和outfile可以是文件对象（实际上是具有readline()方法（用于infile）或write()方法（用于outfile）的任何对象）或命名文件的字符串。如果infile和outfile都是字符串，它们可能具有相同的值。如果decode_base64参数被提供并且测试为true，那么以base64编码编码的任何部分也被解码。

mimify.mime_decode_header(line)

返回在编码标题行的解码版本线。这仅支持ISO 8859-1字符集（Latin-1）。

mimify.mime_encode_header(line)

返回在标题行中的一个MIME编码的版本线。

mimify.MAXLEN

默认情况下，如果零件包含任何非ASCII字符（设置了第8位的字符），或者存在任何长于MAXLEN字符的行（默认值为200），则零件将被编码为quoted-printable 。

mimify.CHARSET

如果未在邮件标题中指定，则必须填写字符集。所使用的字符串存储在中CHARSET，默认值为ISO-8859-1（也称为Latin1（拉丁语））。

该模块也可以从命令行使用。用法如下：

mimify.py -e [-l length] [infile [outfile]]
mimify.py -d [-b] [infile [outfile]]

分别进行编码（缩小）和解码（unmimify）。infile默认为标准输入，outfile默认为标准输出。可以为输入和输出指定相同的文件。

如果在编码时给出-l选项，如果有任何行比指定的长度长，则包含的部分将被编码。

如果在解码时给出-b选项，则任何base64部件也将被解码。