email.iterators.md

1> **Источник:** https://python-all.ru/3.13/library/email.iterators.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `email.iterators`: Итераторы89**Исходный код:** [Lib/email/iterators.py](https://python-all.ru/src/3.13/Lib/email/iterators.py)1011---1213Обход дерева объектов сообщения довольно прост с помощью метода [`Message.walk`](https://python-all.ru/3.13/library/email.compat32-message.html#email.message.Message.walk). Модуль `email.iterators` предоставляет несколько полезных итераций более высокого уровня по деревьям объектов сообщения.1415#### `email.iterators.body_line_iterator(msg, decode=False)`1617Эта функция обходит все полезные нагрузки во всех подчастях *msg*, возвращая строковые полезные нагрузки строка за строкой. Она пропускает все заголовки подчастей, а также пропускает любую подчасть, полезная нагрузка которой не является строкой Python. Это примерно эквивалентно чтению плоского текстового представления сообщения из файла с помощью [`readline()`](https://python-all.ru/3.13/library/io.html#io.TextIOBase.readline), с пропуском всех промежуточных заголовков.1819Необязательный параметр *decode* передаётся в [`Message.get_payload`](https://python-all.ru/3.13/library/email.compat32-message.html#email.message.Message.get_payload).2021#### `email.iterators.typed_subpart_iterator(msg, maintype='text', subtype=None)`2223Эта функция обходит все подчасти *msg*, возвращая только те подчасти, которые соответствуют MIME-типу, заданному параметрами *maintype* и *subtype*.2425Обратите внимание, что *subtype* необязателен; если он опущен, то сопоставление MIME-типа подчасти выполняется только по основному типу. *maintype* также необязателен; по умолчанию он равен *text*.2627Таким образом, по умолчанию `typed_subpart_iterator()` возвращает каждую подчасть, имеющую MIME-тип *text/\**.2829Следующая функция добавлена как полезный инструмент отладки. Она должна *не* считаться частью поддерживаемого публичного интерфейса пакета.3031#### `email.iterators._structure(msg, fp=None, level=0, include_default=False)`3233Выводит представление типов содержимого структуры объекта сообщения с отступами. Например:3435```pycon36>>> msg = email.message_from_file(somefile)37>>> _structure(msg)38multipart/mixed39    text/plain40    text/plain41    multipart/digest42        message/rfc82243            text/plain44        message/rfc82245            text/plain46        message/rfc82247            text/plain48        message/rfc82249            text/plain50        message/rfc82251            text/plain52    text/plain53```5455Необязательный параметр *fp* – это файлоподобный объект, в который выводится результат. Он должен быть пригоден для функции [`print()`](https://python-all.ru/3.13/library/functions.html#print) в Python. *level* используется внутри. *include\_default*, если равен true, также выводит тип по умолчанию.56