email: Итераторы¶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, возвращая только те подчасти, которые соответствуют MIME-типу, заданному параметрами maintype и subtype.
Обратите внимание, что subtype необязателен; если он опущен, то сопоставление MIME-типа подчасти выполняется только по основному типу. maintype также необязателен; по умолчанию он равен text.
Таким образом, по умолчанию typed_subpart_iterator() возвращает каждую подчасть, имеющую MIME-тип text/*.
Следующая функция добавлена как полезный инструмент отладки. Она должна не считаться частью поддерживаемого публичного интерфейса пакета.
- email.iterators._structure(msg[, fp[, level]])¶
Выводит представление типов содержимого структуры объекта сообщения с отступами. Например:
>>> 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
Необязательный fp – это файлоподобный объект для вывода результата. Он должен подходить для функции print() языка Python. level используется внутри.