MimeWriter — Универсальный записыватель файлов MIME

В этом модуле определен класс MimeWriter. Класс MimeWriter реализует базовый форматировщик для создания файлов MIME с несколькими частями. Он не ищет внутри выходного файла и не использует большие буферы. Необходимо записывать части в том порядке, в котором они должны быть в итоговом файле. Класс MimeWriter буферизует добавляемые вами заголовки, позволяя изменять их порядок.

class MimeWriter.MimeWriter(fp)

Возвращает новый экземпляр класса MimeWriter. Единственный аргумент, fp, представляет собой объект файла для записи. Обратите внимание, что можно использовать и объект StringIO.

1. Объекты MimeWriter

MimeWriter экземпляры имеют следующие методы:

MimeWriter.addheader(key, value[, prefix])

Добавляет строку заголовка к сообщению MIME. key — имя заголовка, а value — его значение. Необязательный аргумент prefix определяет место вставки заголовка; 0 — добавление в конец, 1 — вставка в начало. По умолчанию заголовок добавляется в конец.

MimeWriter.flushheaders()

Принудительно записывает все накопленные заголовки (и удаляет их из памяти). Это полезно, если вам не нужен тело части, например, для подчасти типа message/rfc822, которая (неправильно) используется для хранения информации, подобной заголовкам.

MimeWriter.startbody(ctype[, plist[, prefix]])

Возвращает объект, похожий на файл, который можно использовать для записи в тело сообщения. Тип содержимого устанавливается в предоставленное ctype, а необязательный параметр plist предоставляет дополнительные параметры для объявления типа содержимого. prefix работает так же, как и в addheader(), за исключением того, что по умолчанию происходит вставка в начало.

MimeWriter.startmultipartbody(subtype[, boundary[, plist[, prefix]]])

Возвращает объект, похожий на файл, который можно использовать для записи в тело сообщения. Кроме того, этот метод инициализирует код многочастного сообщения, где subtype предоставляет тип подчасти сообщения, boundary может предоставить пользовательское значение разделителя, а plist — необязательные параметры для типа подчасти. prefix работает так же, как и в startbody(). Подчасти должны создаваться с помощью nextpart().

MimeWriter.nextpart()

Возвращает новый экземпляр MimeWriter, представляющий собой отдельную часть в сообщении с несколькими частями. Это можно использовать для записи части, а также для создания рекурсивно сложных сообщений с несколькими частями. Сначала необходимо инициализировать сообщение с помощью startmultipartbody() перед использованием nextpart().

MimeWriter.lastpart()

Используется для обозначения последней части сообщения с несколькими частями и всегда должна использоваться при записи таких сообщений.