> **Источник:** https://python-all.ru/2.7/library/email.iterators.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# 18.1.10. [`email.iterators`](https://python-all.ru/2.7/library/email.iterators.html#module-email.iterators): Итераторы

Обход дерева объектов сообщения довольно прост с помощью метода [`Message.walk`](https://python-all.ru/2.7/library/email.message.html#email.message.Message.walk). Модуль [`email.iterators`](https://python-all.ru/2.7/library/email.iterators.html#module-email.iterators) предоставляет несколько полезных итераций более высокого уровня по деревьям объектов сообщения.

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

Эта функция обходит все полезные нагрузки во всех подчастях *msg*, возвращая строковые полезные нагрузки строка за строкой. Она пропускает все заголовки подчастей, а также пропускает любую подчасть, полезная нагрузка которой не является строкой Python. Это примерно эквивалентно чтению плоского текстового представления сообщения из файла с помощью [`readline()`](https://python-all.ru/2.7/library/io.html#io.TextIOBase.readline), с пропуском всех промежуточных заголовков.

Необязательный параметр *decode* передаётся в [`Message.get_payload`](https://python-all.ru/2.7/library/email.message.html#email.message.Message.get_payload).

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

Эта функция обходит все подчасти *msg*, возвращая только те подчасти, которые соответствуют MIME-типу, заданному параметрами *maintype* и *subtype*.

Обратите внимание, что *subtype* необязателен; если он опущен, то сопоставление MIME-типа подчасти выполняется только по основному типу. *maintype* также необязателен; по умолчанию он равен *text*.

Таким образом, по умолчанию [`typed_subpart_iterator()`](https://python-all.ru/2.7/library/email.iterators.html#email.iterators.typed_subpart_iterator) возвращает каждую подчасть, имеющую MIME-тип *text/\**.

Следующая функция добавлена как полезный инструмент отладки. Она должна *не* считаться частью поддерживаемого публичного интерфейса пакета.

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

Выводит представление типов содержимого структуры объекта сообщения с отступами. Например:

```python
>>> 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* используется внутри.