email.iterators.md

1> **Источник:** https://python-all.ru/3.1/library/email.iterators.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 18.1.10. [`email`](https://python-all.ru/3.1/library/email.html#module-email): Итераторы89Итерация по дереву объектов сообщения довольно проста с помощью метода `Message.walk()`. Модуль `email.iterators` предоставляет несколько полезных итераций более высокого уровня по деревьям объектов сообщений.1011#### `email.iterators.body_line_iterator(msg, decode=False)`1213Эта функция перебирает все полезные нагрузки во всех подчастях *msg*, возвращая строковые полезные нагрузки строка за строкой. Она пропускает заголовки всех подчастей и пропускает любую подчасть с полезной нагрузкой, не являющейся строкой Python. Это примерно эквивалентно чтению плоского текстового представления сообщения из файла с помощью `readline()`, с пропуском всех промежуточных заголовков.1415Необязательный параметр *decode* передаётся в `Message.get_payload()`.1617#### `email.iterators.typed_subpart_iterator(msg, maintype='text', subtype=None)`1819Эта функция обходит все подчасти *msg*, возвращая только те подчасти, которые соответствуют MIME-типу, заданному параметрами *maintype* и *subtype*.2021Обратите внимание, что *subtype* необязателен; если он опущен, то сопоставление MIME-типа подчасти выполняется только по основному типу. *maintype* также необязателен; по умолчанию он равен *text*.2223Таким образом, по умолчанию [`typed_subpart_iterator()`](https://python-all.ru/3.1/library/email.iterators.html#email.iterators.typed_subpart_iterator) возвращает каждую подчасть, имеющую MIME-тип *text/\**.2425Следующая функция добавлена как полезный инструмент отладки. Она должна *не* считаться частью поддерживаемого публичного интерфейса пакета.2627#### `email.iterators._structure(msg, fp=None, level=0, include_default=False)`2829Выводит представление типов содержимого структуры объекта сообщения с отступами. Например:3031```python32>>> msg = email.message_from_file(somefile)33>>> _structure(msg)34multipart/mixed35    text/plain36    text/plain37    multipart/digest38        message/rfc82239            text/plain40        message/rfc82241            text/plain42        message/rfc82243            text/plain44        message/rfc82245            text/plain46        message/rfc82247            text/plain48    text/plain49```5051Необязательный параметр *fp* – это файлоподобный объект, в который выводится результат. Он должен быть пригоден для функции [`print()`](https://python-all.ru/3.1/library/functions.html#print) в Python. *level* используется внутренне. Если *include\_default* равен true, также выводится тип по умолчанию.52