MimeWriter
MimeWriter — Generic MIME file writer
自2.3版弃用:email
应优先使用软件包MimeWriter
。该模块仅用于保持向后兼容性。
这个模块定义了这个类MimeWriter
。本MimeWriter
类实现创建MIME多部分文件基本格式。它不寻找输出文件,也不使用大量的缓冲区空间。您必须按照在最终文件中出现的顺序编写部件。MimeWriter
会缓冲您添加的标题,从而允许您重新排列它们的顺序。
class MimeWriter.MimeWriter(fp)
返回MimeWriter
该类的新实例。通过的唯一参数fp
是要用于写入的文件对象。请注意,StringIO
也可以使用对象。
1. MimeWriter对象
MimeWriter
实例具有以下方法:
MimeWriter.addheader(key, value[, prefix])
将标题行添加到MIME消息。的关键
是标题,其中的名称值
明显提供了标头的值
。可选的参数前缀
决定了头插入的位置; 0
意味着在最后添加,1
在开始时插入。默认是追加。
MimeWriter.flushheaders()
导致迄今积累的所有标题被写出(并被遗忘)。如果你根本不需要正文部分,这非常有用,例如,用于存储某些类头信息的(错误)message / rfc822
类型的子部分。
MimeWriter.startbody(ctype[, plist[, prefix]])
返回可用于写入消息正文的文件类对象。内容类型设置为提供的ctype
,可选参数plist
为内容类型声明提供附加参数。前缀
函数,addheader()
除了缺省值是在开始时插入的。
MimeWriter.startmultipartbody(subtype[, boundary[, plist[, prefix]]])
返回可用于写入消息正文的文件类对象。此外,此方法初始化多部分代码,其中子类型
提供多部分子类型
,边界
可提供用户定义的边界
规范,并且plist
为子类型
提供可选参数。前缀
函数如startbody()
。子部分应该使用创建nextpart()
。
MimeWriter.nextpart()
返回一个新实例,MimeWriter
它表示多部分消息中的单独部分。这可以用于编写零件以及用于创建递归复杂的多部分消息。该消息必须startmultipartbody()
在使用之前首先进行初始化nextpart()
。
MimeWriter.lastpart()
这用于指定多部分消息的最后部分,并且在写入多部分消息时应始终
使用它。