email.message.Message: Представление электронного сообщения с помощью API compat32

Класс Message очень похож на класс EmailMessage, без методов, добавленных этим классом, и с немного отличающимся поведением по умолчанию некоторых других методов. Мы также документируем здесь некоторые методы, которые, хотя и поддерживаются классом EmailMessage, не рекомендуются, если вы не работаете с устаревшим кодом.

В остальном философия и структура двух классов одинаковы.

В этом документе описывается поведение по умолчанию (для Message) политики Compat32. Если вы собираетесь использовать другую политику, вам следует использовать класс EmailMessage вместо этого.

Электронное сообщение состоит из заголовков и тела. Заголовки должны иметь имена и значения в стиле RFC 5322, где имя и значение поля разделены двоеточием. Двоеточие не является частью ни имени, ни значения поля. Тело может быть простым текстовым сообщением, двоичным объектом или структурированной последовательностью подсообщений, каждое со своим набором заголовков и своим телом. Последний тип тела указывается тем, что у сообщения есть MIME-тип, такой как multipart/* или message/rfc822.

Концептуальная модель, предоставляемая объектом Message, представляет собой упорядоченный словарь заголовков с дополнительными методами для доступа к специализированной информации из заголовков, для доступа к телу, для генерации сериализованной версии сообщения и для рекурсивного обхода дерева объектов. Обратите внимание, что дублирование заголовков поддерживается, но для доступа к ним необходимо использовать специальные методы.

Псевдословарь Message индексируется по именам заголовков, которые должны быть значениями ASCII. Значения словаря — это строки, которые, как предполагается, содержат только символы ASCII; для не-ASCII входных данных существует специальная обработка, но она не всегда приводит к корректным результатам. Заголовки хранятся и возвращаются в форме с сохранением регистра, но имена полей сравниваются без учета регистра. Также может быть один заголовок конверта, также известный как заголовок Unix-From или заголовок From_. Тело — это строка или байты в случае простых объектов сообщения или список объектов Message для документов-контейнеров MIME (например, multipart/* и message/rfc822).

Вот методы класса Message:

class email.message.Message(policy=compat32)

Если параметр policy указан (он должен быть экземпляром класса policy), используйте правила, которые он задаёт, для обновления и сериализации представления сообщения. Если policy не задан, используйте политику compat32, которая поддерживает обратную совместимость с версией email-пакета Python 3.2. Дополнительную информацию см. в документации policy.

Изменено в версии 3.3: Добавлен ключевой аргумент policy.

as_string(unixfrom=False, maxheaderlen=0, policy=None)

Возвращает всё сообщение, сглаженное в строку. Когда необязательный параметр unixfrom имеет значение true, заголовок конверта включается в возвращаемую строку. Значение unixfrom по умолчанию — False. По причинам обратной совместимости, maxheaderlen по умолчанию имеет значение 0, поэтому, если вам нужно другое значение, вы должны явно его переопределить (значение, заданное для max_line_length в политике, будет проигнорировано этим методом). Аргумент policy может быть использован для переопределения политики по умолчанию, полученной из экземпляра сообщения. Это может быть использовано для управления некоторыми форматами, производимыми методом, так как указанная policy будет передана в Generator.

Сглаживание сообщения может вызвать изменения в Message, если для завершения преобразования в строку нужно заполнить значения по умолчанию (например, могут быть сгенерированы или изменены границы MIME).

Обратите внимание, что этот метод предоставляется как удобство и не всегда форматирует сообщение так, как вам нужно. Например, по умолчанию он не выполняет преобразование строк, начинающихся с From, которое необходимо для формата Unix mbox. Для большей гибкости создайте экземпляр Generator и используйте его метод flatten() напрямую. Например:

from io import StringIO
from email.generator import Generator
fp = StringIO()
g = Generator(fp, mangle_from_=True, maxheaderlen=60)
g.flatten(msg)
text = fp.getvalue()

Если объект сообщения содержит двоичные данные, которые не закодированы в соответствии со стандартами RFC, несоответствующие данные будут заменены кодами Юникода «неизвестного символа». (См. также as_bytes() и BytesGenerator.)

Изменено в версии 3.4: Добавлен ключевой аргумент policy.

__str__()

Эквивалентно as_string(). Позволяет str(msg) генерировать строку, содержащую отформатированное сообщение.

as_bytes(unixfrom=False, policy=None)

Возвращает всё сообщение, сглаженное в объект байтов. Когда необязательный параметр unixfrom имеет значение true, заголовок конверта включается в возвращаемую строку. Значение unixfrom по умолчанию — False. Аргумент policy может быть использован для переопределения политики по умолчанию, полученной из экземпляра сообщения. Это может быть использовано для управления некоторыми форматами, производимыми методом, так как указанная policy будет передана в BytesGenerator.

Сглаживание сообщения может вызвать изменения в Message, если для завершения преобразования в строку нужно заполнить значения по умолчанию (например, могут быть сгенерированы или изменены границы MIME).

Обратите внимание, что этот метод предоставляется как удобство и не всегда форматирует сообщение так, как вам нужно. Например, по умолчанию он не выполняет преобразование строк, начинающихся с From, которое необходимо для формата Unix mbox. Для большей гибкости создайте экземпляр BytesGenerator и используйте его метод flatten() напрямую. Например:

from io import BytesIO
from email.generator import BytesGenerator
fp = BytesIO()
g = BytesGenerator(fp, mangle_from_=True, maxheaderlen=60)
g.flatten(msg)
text = fp.getvalue()

Новое в версии 3.4.

__bytes__()

Эквивалентно as_bytes(). Позволяет bytes(msg) генерировать объект байтов, содержащий отформатированное сообщение.

Новое в версии 3.4.

is_multipart()

Возвращает True если содержимое сообщения — список под-Message-объектов, в противном случае возвращает False. Когда is_multipart() возвращает False, содержимое должно быть строковым объектом (который может быть двоичным содержимым, закодированным CTE). (Обратите внимание, что is_multipart() возвращает True не обязательно означает, что «msg.get_content_maintype() == ‘multipart’» вернёт True. Например, is_multipart вернёт True, когда Message имеет тип message/rfc822.)

set_unixfrom(unixfrom)

Устанавливает заголовок конверта сообщения на unixfrom, которое должно быть строкой.

get_unixfrom()

Возвращает заголовок конверта сообщения. По умолчанию возвращает None, если заголовок конверта никогда не устанавливался.

attach(payload)

Добавляет заданное payload к текущему содержимому, которое должно быть None или списком Message-объектов до вызова. После вызова содержимое всегда будет списком Message-объектов. Если вы хотите установить содержимое в скалярный объект (например, строку), используйте set_payload() вместо этого.

Это устаревший метод. В классе EmailMessage его функциональность заменена на set_content() и связанные с ней методы make и add.

get_payload(i=None, decode=False)

Возвращает текущую полезную нагрузку, которая будет списком объектов Message, когда is_multipart() имеет значение True, или строкой, когда is_multipart() имеет значение False. Если полезная нагрузка является списком, и вы изменяете объект списка, вы изменяете полезную нагрузку сообщения на месте.

С необязательным аргументом i, get_payload() вернёт i-й элемент полезной нагрузки, считая с нуля, если is_multipart() имеет значение True. Будет поднято исключение IndexError, если i меньше 0 или больше или равно количеству элементов в полезной нагрузке. Если полезная нагрузка является строкой (т.е. is_multipart() имеет значение False) и указан i, поднимается исключение TypeError.

Необязательный decode — флаг, указывающий, следует ли декодировать полезную нагрузку или нет, в соответствии с заголовком Content-Transfer-Encoding. Когда True и сообщение не является составным, полезная нагрузка будет декодирована, если значение этого заголовка равно quoted-printable или base64. Если используется другой код кодирования или заголовок Content-Transfer-Encoding отсутствует, полезная нагрузка возвращается как есть (не декодированная). Во всех случаях возвращаемое значение — двоичные данные. Если сообщение является составным и флаг decode равен True, то возвращается None. Если полезная нагрузка закодирована в base64 и не была идеально сформирована (отсутствует заполнение, символы за пределами алфавита base64), соответствующий дефект будет добавлен к свойству defects сообщения (InvalidBase64PaddingDefect или InvalidBase64CharactersDefect соответственно).

Когда decode имеет значение False (по умолчанию), тело возвращается как строка без декодирования Content-Transfer-Encoding. Однако, для Content-Transfer-Encoding 8bit, делается попытка декодировать исходные байты, используя charset, указанное в заголовке Content-Type, с обработчиком ошибок replace. Если charset не указано или указанное charset не распознаётся пакетом email, тело декодируется с помощью кодировки по умолчанию ASCII.

Это устаревший метод. В классе EmailMessage его функциональность заменена на get_content() и iter_parts().

set_payload(payload, charset=None)

Устанавливает всю полезную нагрузку объекта сообщения на payload. Клиент несёт ответственность за соблюдение инвариантов полезной нагрузки. Необязательный charset задаёт кодировку по умолчанию сообщения; подробности см. в set_charset().

Это устаревший метод. В классе EmailMessage его функциональность заменена на set_content().

set_charset(charset)

Устанавливает кодировку символов полезной нагрузки на charset, который может быть экземпляром Charset (см. email.charset), строкой, обозначающей кодировку символов, или None. Если это строка, она будет преобразована в экземпляр Charset. Если charset равен None, параметр charset будет удалён из заголовка Content-Type (сообщение не будет изменено иначе). Любое другое значение приведёт к исключению TypeError.

Если заголовок MIME-Version отсутствует, он будет добавлен. Если заголовок Content-Type отсутствует, он будет добавлен со значением text/plain. Существует ли заголовок Content-Type или нет, его параметр charset будет установлен на charset.output_charset. Если charset.input_charset и charset.output_charset различаются, полезная нагрузка будет закодирована заново в output_charset. Если заголовок Content-Transfer-Encoding отсутствует, то полезная нагрузка будет закодирована, если необходимо, с использованием указанного Charset, и будет добавлен соответствующий заголовок. Если заголовок Content-Transfer-Encoding уже существует, предполагается, что полезная нагрузка уже правильно закодирована с использованием этого Content-Transfer-Encoding и не будет изменена.

Это устаревший метод. В классе EmailMessage его функциональность заменена параметром charset метода email.emailmessage.EmailMessage.set_content().

get_charset()

Возвращает экземпляр Charset, связанный с полезной нагрузкой сообщения.

Это устаревший метод. В классе EmailMessage он всегда возвращает None.

Следующие методы реализуют интерфейс отображения для доступа к заголовкам RFC 2822 сообщения. Обратите внимание, что между этими методами и обычным интерфейсом отображения (т.е. словарем) есть некоторые семантические различия. Например, в словаре нет дублирующих ключей, но здесь могут быть дублирующиеся заголовки сообщения. Кроме того, в словарях нет гарантированного порядка ключей, возвращаемых keys(), но в объекте Message заголовки всегда возвращаются в том порядке, в котором они появились в исходном сообщении или были добавлены в сообщение позже. Любой заголовок, удалённый и затем повторно добавленный, всегда добавляется в конец списка заголовков.

Эти семантические различия являются намеренными и предвзяты в сторону максимального удобства.

Обратите внимание, что во всех случаях любой заголовок конверта, присутствующий в сообщении, не включается в интерфейс отображения.

В модели, сгенерированной из байтов, любые значения заголовков, которые (вопреки RFC) содержат не-ASCII байты, будут, при получении через этот интерфейс, представлены как объекты Header с кодировкой unknown-8bit.

__len__()

Возвращает общее количество заголовков, включая дубликаты.

__contains__(name)

Возвращает True, если объект сообщения имеет поле с именем name. Сопоставление выполняется без учёта регистра, и name не должно включать в себя заключительный двоеточие. Используется для оператора in, например:

if 'message-id' in myMessage:
   print('Message-ID:', myMessage['message-id'])

__getitem__(name)

Возвращает значение поля заголовка с указанным именем. name не должно включать двоеточие. Если заголовок отсутствует, возвращается None; исключение KeyError никогда не поднимается.

Обратите внимание, что если указанное поле появляется более одного раза в заголовках сообщения, то какое именно из этих значений поля будет возвращено, не определено. Используйте метод get_all() для получения значений всех существующих заголовков с указанным именем.

__setitem__(name, val)

Добавляет заголовок в сообщение с именем поля name и значением val. Поле добавляется в конец существующих полей сообщения.

Обратите внимание, что это не перезаписывает или удаляет любой существующий заголовок с тем же именем. Если вы хотите убедиться, что новый заголовок является единственным присутствующим в сообщении с именем поля name, удалите поле сначала, например:

del msg['subject']
msg['subject'] = 'Python roolz!'

__delitem__(name)

Удаляет все вхождения поля с именем name из заголовков сообщения. Если указанного поля нет в заголовках, исключение не поднимается.

keys()

Возвращает список всех имён полей заголовков сообщения.

values()

Возвращает список всех значений полей сообщения.

items()

Возвращает список пар кортежей, содержащих все заголовки и значения полей сообщения.

get(name, failobj=None)

Возвращает значение поля с заданным именем. Это идентично __getitem__(), за исключением того, что необязательный failobj возвращается, если заданного заголовка нет (по умолчанию None).

Вот некоторые дополнительные полезные методы:

get_all(name, failobj=None)

Возвращает список всех значений для поля с именем name. Если в сообщении нет заголовков с указанным именем, возвращается failobj (по умолчанию None).

add_header(_name, _value, **_params)

Расширенная настройка заголовка. Этот метод аналогичен __setitem__(), за исключением того, что дополнительные параметры заголовка могут быть указаны в качестве ключевых аргументов. _name — добавляемое поле заголовка, а _value — основное значение заголовка.

Для каждого элемента в словаре ключевых аргументов _params ключ используется в качестве имени параметра, при этом подчеркивания преобразуются в дефисы (поскольку дефисы запрещены в идентификаторах Python). Обычно параметр будет добавлен как key="value" , если значение не None, в этом случае добавляется только ключ. Если значение содержит не-ASCII символы, оно может быть указано как тройка кортежей в формате (CHARSET, LANGUAGE, VALUE), где CHARSET — строка, обозначающая кодировку, которая будет использоваться для кодирования значения, LANGUAGE обычно может быть установлено в None или пустую строку (см. RFC 2231 для других возможностей), а VALUE — строка, содержащая не-ASCII символы. Если тройка кортежей не передается и значение содержит не-ASCII символы, оно автоматически кодируется в формате RFC 2231 с использованием CHARSET utf-8 и LANGUAGE None.

Вот пример:

msg.add_header('Content-Disposition', 'attachment', filename='bud.gif')

Это добавит заголовок, который выглядит как

Content-Disposition: attachment; filename="bud.gif"

Пример с не-ASCII символами:

msg.add_header('Content-Disposition', 'attachment',
               filename=('iso-8859-1', '', 'Fußballer.ppt'))

Что приводит к

Content-Disposition: attachment; filename*="iso-8859-1''Fu%DFballer.ppt"

replace_header(_name, _value)

Заменяет заголовок. Заменяет первый заголовок в сообщении, соответствующий _name, сохраняя порядок заголовков и регистр имени поля. Если соответствующий заголовок не найден, возникает KeyError.

get_content_type()

Возвращает тип содержимого сообщения. Возвращаемая строка приводится к нижнему регистру в формате maintype/subtype. Если в сообщении не было заголовка Content-Type, возвращается тип по умолчанию, заданный get_default_type(). Поскольку согласно RFC 2045, сообщения всегда имеют тип по умолчанию, get_content_type() всегда возвращает значение.

RFC 2045 определяет тип сообщения по умолчанию как text/plain, если оно не находится внутри контейнера multipart/digest, в этом случае это будет message/rfc822. Если заголовок Content-Type имеет некорректную спецификацию типа, RFC 2045 предписывает, что типом по умолчанию должен быть text/plain.

get_content_maintype()

Возвращает основное содержимое типа сообщения. Это часть maintype строки, возвращаемой get_content_type().

get_content_subtype()

Возвращает подтип содержимого сообщения. Это часть subtype строки, возвращаемой get_content_type().

get_default_type()

Возвращает тип содержимого по умолчанию. Большинство сообщений имеют тип содержимого по умолчанию text/plain, за исключением сообщений, которые являются подчастями контейнеров multipart/digest. Такие подчасти имеют тип содержимого по умолчанию message/rfc822.

set_default_type(ctype)

Устанавливает тип содержимого по умолчанию. ctype должен быть либо text/plain, либо message/rfc822, хотя это не проверяется. Тип содержимого по умолчанию не хранится в заголовке Content-Type.

get_params(failobj=None, header='content-type', unquote=True)

Возвращает параметры сообщения Content-Type в виде списка. Элементы возвращаемого списка являются парами ключ/значение, разделенными знаком '=' . Левая часть '=' — ключ, правая — значение. Если в параметре нет знака '=' , значение пустая строка, в противном случае значение, как описано в get_param(), и не заключено в кавычки, если необязательный unquote равен True (по умолчанию).

Необязательный failobj — объект, который возвращается, если заголовок Content-Type отсутствует. Необязательный header — заголовок для поиска вместо Content-Type.

Это устаревший метод. На EmailMessage классе его функциональность заменена свойством params отдельных объектов заголовка, возвращаемых методами доступа к заголовкам.

get_param(param, failobj=None, header='content-type', unquote=True)

Возвращает значение параметра заголовка Content-Type param в виде строки. Если у сообщения нет заголовка Content-Type или такого параметра нет, возвращается failobj (по умолчанию None).

Необязательный header, если указан, определяет заголовок сообщения для использования вместо Content-Type.

Ключи параметров всегда сравниваются без учета регистра. Возвращаемое значение может быть либо строкой, либо тройкой кортежей, если параметр был закодирован в формате RFC 2231. Когда это тройка кортежей, элементы значения имеют вид (CHARSET, LANGUAGE, VALUE). Обратите внимание, что как CHARSET, так и LANGUAGE могут быть None, в этом случае VALUE следует считать закодированным в кодировке us-ascii. Вы обычно можете игнорировать LANGUAGE.

Если ваше приложение не заботится о том, был ли параметр закодирован в формате RFC 2231, вы можете сжать значение параметра, вызвав email.utils.collapse_rfc2231_value(), передав значение, возвращаемое get_param(). Это вернёт соответствующе декодированную строку Unicode, когда значение является кортежем, или исходную строку без кавычек, если это не так. Например:

rawparam = msg.get_param('foo')
param = email.utils.collapse_rfc2231_value(rawparam)

В любом случае, значение параметра (либо возвращаемая строка, либо элемент VALUE в тройке кортежей) всегда без кавычек, если unquote не установлено в False.

Это устаревший метод. На EmailMessage классе его функциональность заменена свойством params отдельных объектов заголовка, возвращаемых методами доступа к заголовкам.

set_param(param, value, header='Content-Type', requote=True, charset=None, language='', replace=False)

Установите параметр в заголовке Content-Type. Если параметр уже существует в заголовке, его значение будет заменено на value. Если заголовок Content-Type еще не определен для этого сообщения, он будет установлен в text/plain, а новое значение параметра будет добавлено в соответствии с RFC 2045.

Необязательный параметр header указывает альтернативный заголовок Content-Type, а все параметры будут приведены к кавычкам по необходимости, если необязательный параметр requote не False (по умолчанию True).

Если задан необязательный параметр charset, параметр будет закодирован в соответствии с RFC 2231. Необязательный параметр language указывает язык RFC 2231, по умолчанию пустая строка. И charset, и language должны быть строками.

Если replace False (по умолчанию), заголовок перемещается в конец списка заголовков. Если replace True, заголовок будет обновлён на месте.

Изменено в версии 3.4: replace ключевое слово было добавлено.

del_param(param, header='content-type', requote=True)

Полностью удаляет заданный параметр из заголовка Content-Type. Заголовок будет переписан на месте без параметра и его значения. Все значения будут приведены к кавычкам по необходимости, если requote не False (по умолчанию True). Необязательный параметр header указывает альтернативу для Content-Type.

set_type(type, header='Content-Type', requote=True)

Установите основной тип и подтип для заголовка Content-Type. type должен быть строкой в формате maintype/subtype, иначе генерируется ValueError.

Этот метод заменяет заголовок Content-Type, сохраняя все параметры на месте. Если requote False, это сохраняет имеющуюся квотацию заголовка, в противном случае параметры будут приведены к кавычкам (по умолчанию).

Альтернативный заголовок может быть указан в аргументе header. При установке заголовка Content-Type также добавляется заголовок MIME-Version.

Это устаревший метод. В классе EmailMessage его функциональность заменена методами make_ и add_.

get_filename(failobj=None)

Возвращает значение параметра filename заголовка Content-Disposition сообщения. Если заголовок не имеет параметра filename, этот метод переходит к поиску параметра name в заголовке Content-Type. Если ни тот, ни другой не найдены или заголовок отсутствует, возвращается failobj. Возвращаемая строка всегда будет без кавычек в соответствии с email.utils.unquote().

get_boundary(failobj=None)

Возвращает значение параметра boundary заголовка Content-Type сообщения или failobj, если заголовок отсутствует или не имеет параметра boundary. Возвращаемая строка всегда будет без кавычек в соответствии с email.utils.unquote().

set_boundary(boundary)

Устанавливает параметр boundary заголовка Content-Type в значение boundary. set_boundary() всегда приводит boundary к кавычкам по необходимости. HeaderParseError генерируется, если у объекта сообщения нет заголовка Content-Type.

Обратите внимание, что использование этого метода отличается от удаления старого заголовка Content-Type и добавления нового с новым параметром boundary с помощью add_header(), так как set_boundary() сохраняет порядок заголовка Content-Type в списке заголовков. Однако он не сохраняет какие-либо продолжения строк, которые могли быть в исходном заголовке Content-Type.

get_content_charset(failobj=None)

Возвращает параметр charset заголовка Content-Type, приведённый к нижнему регистру. Если заголовок Content-Type отсутствует или в нём нет параметра charset, возвращается failobj.

Обратите внимание, что этот метод отличается от get_charset(), который возвращает объект Charset для кодировки тела сообщения по умолчанию.

get_charsets(failobj=None)

Возвращает список, содержащий имена наборов символов в сообщении. Если сообщение является multipart, список будет содержать по одному элементу для каждого подэлемента в полезной нагрузке, иначе он будет списком длиной 1.

Каждый элемент списка будет строкой, представляющей значение параметра charset в заголовке Content-Type для представленного подэлемента. Однако, если у подэлемента нет заголовка Content-Type, параметра charset, или он не имеет основного типа MIME text, то соответствующий элемент в возвращаемом списке будет failobj.

get_content_disposition()

Возвращает значение заголовка Content-Disposition сообщения (в нижнем регистре без параметров), если он существует, или None. Возможные значения для этого метода: inline, attachment или None , если сообщение соответствует RFC 2183.

Добавлена в версии 3.5.

walk()

Метод walk() — это универсальный генератор, который можно использовать для итерации по всем частям и подчастям дерева объекта сообщения в порядке обхода в глубину. Обычно вы используете walk() как итератор в цикле for; на каждой итерации возвращается следующий подэлемент.

Вот пример, который выводит тип MIME каждой части структуры сообщения multipart:

>>> for part in msg.walk():
...     print(part.get_content_type())
multipart/report
text/plain
message/delivery-status
text/plain
text/plain
message/rfc822
text/plain

walk перебирает подчасти любой части, где is_multipart() возвращает True, даже если msg.get_content_maintype() == 'multipart' может возвращать False. Это можно увидеть в нашем примере, воспользовавшись вспомогательной функцией отладки _structure:

>>> for part in msg.walk():
...     print(part.get_content_maintype() == 'multipart',
...           part.is_multipart())
True True
False False
False True
False False
False False
False True
False False
>>> _structure(msg)
multipart/report
    text/plain
    message/delivery-status
        text/plain
        text/plain
    message/rfc822
        text/plain

Здесь части message не являются multiparts, но они содержат подчасти. is_multipart() возвращает True и walk спускается в подчасти.

Message объекты также могут необязательно содержать два атрибута экземпляра, которые могут быть использованы при генерации простого текста сообщения MIME.

preamble

Формат MIME-документа позволяет включать некоторый текст между пустой строкой после заголовков и первой строкой границы раздела. Обычно этот текст не отображается в почтовом клиенте, понимающем MIME, так как он находится вне стандартного MIME-формата. Однако при просмотре исходного текста сообщения или при просмотре сообщения в почтовом клиенте, не понимающем MIME, этот текст может стать видимым.

Атрибут preamble содержит этот дополнительный текст вне MIME-формата для MIME-документов. Когда Parser обнаруживает текст после заголовков, но перед первой строкой границы, он присваивает этот текст атрибуту preamble сообщения. Когда Generator генерирует обычный текстовый формат MIME-сообщения и находит атрибут preamble, он записывает этот текст в область между заголовками и первой границей. Подробнее см. email.parser и email.generator.

Обратите внимание, что если у объекта сообщения нет преамбулы, то атрибут preamble будет None.

epilogue

Атрибут epilogue действует аналогично атрибуту preamble, за исключением того, что он содержит текст, появляющийся между последней границей и концом сообщения.

Не нужно устанавливать epilogue в пустую строку, чтобы Generator печатал новую строку в конце файла.

defects

Атрибут defects содержит список всех проблем, обнаруженных при парсинге этого сообщения. Подробное описание возможных дефектов парсинга см. в email.errors.