18.1.10. email.iterators: 迭代器

通过 Message.walk 方法来迭代消息对象树是相当容易的。 email.iterators 模块提供了一些适用于消息对象树的高层级迭代器。

email.iterators.body_line_iterator(msg[, decode])

此对象会迭代 msg 的所有子部分中的所有载荷,逐行返回字符串载荷。 它会跳过所有子部分的标头,并且它也会跳过任何包含不为 Python 字符串的载荷的子部分。 这基本上等价于使用 readline() 从一个文件读取消息的纯文本表示形式,并跳过所有中间的标头。

可选的 decode 会被传递给 Message.get_payload

email.iterators.typed_subpart_iterator(msg[, maintype[, subtype]])

此函数会迭代 msg 的所有子部分,只返回其中与 maintypesubtype 所指定的 MIME 类型相匹配的子部分。

请注意 subtype 是可选项;如果省略,则仅使用主类型来进行子部分 MIME 类型的匹配。 maintype 也是可选项;它的默认值为 text

因此,在默认情况下 typed_subpart_iterator() 会返回每一个 MIME 类型为 text/* 的子部分。

增加了以下函数作为有用的调试工具。 它 不应当 被视为该包所支持的公共接口的组成部分。

email.iterators._structure(msg[, fp[, level]])

Prints an indented representation of the content types of the message object structure. For example:

>>> msg = email.message_from_file(somefile)
>>> _structure(msg)
multipart/mixed
    text/plain
    text/plain
    multipart/digest
        message/rfc822
            text/plain
        message/rfc822
            text/plain
        message/rfc822
            text/plain
        message/rfc822
            text/plain
        message/rfc822
            text/plain
    text/plain

Optional fp is a file-like object to print the output to. It must be suitable for Python’s extended print statement. level is used internally.