email.message
: Представление сообщения электронной почты¶
Источник: Lib/email/message.py
Added in version 3.6: [1]
Центральным классом в пакете email
является класс EmailMessage
, импортированный из модуля email.message
. Он является базовым классом для объектной модели email
. EmailMessage
предоставляет основную функциональность для установки и запроса полей заголовка, доступа к телу сообщения, а также для создания или изменения структурированных сообщений.
Электронное сообщение состоит из заголовков и груза (который также называют содержанием). Заголовки представляют собой имена и значения полей в стиле RFC 5322 или RFC 6532, где имя поля и значение разделены двоеточием. Двоеточие не является частью ни имени поля, ни его значения. Полезная нагрузка может быть простым текстовым сообщением, или двоичным объектом, или структурированной последовательностью подсообщений, каждое из которых имеет свой собственный набор заголовков и свою собственную полезную нагрузку. На последний тип полезной нагрузки указывает сообщение, имеющее тип MIME, например multipart/* или message/rfc822.
Концептуальная модель, предоставляемая объектом EmailMessage
, представляет собой упорядоченный словарь заголовков, соединенный с платежной нагрузкой, которая представляет собой RFC 5322 тело сообщения, которое может быть списком под-EmailMessage
объектов. В дополнение к обычным методам словаря для доступа к именам и значениям заголовков, существуют методы для доступа к специализированной информации из заголовков (например, тип содержимого MIME), для работы с полезной нагрузкой, для генерации сериализованной версии сообщения и для рекурсивного перехода по дереву объектов.
Словарный интерфейс EmailMessage
индексируется по именам заголовков, которые должны быть ASCII-значениями. Значения словаря - это строки с некоторыми дополнительными методами. Заголовки хранятся и возвращаются в форме, сохраняющей регистр, но имена полей сопоставляются без учета регистра. Ключи упорядочены, но, в отличие от настоящего словаря, могут быть дубликаты. Для работы с заголовками, имеющими дубликаты ключей, предусмотрены дополнительные методы.
В случае простых объектов сообщений payload представляет собой либо строку, либо объект байтов, либо список объектов EmailMessage
для документов-контейнеров MIME, таких как объекты сообщений multipart/* и message/rfc822.
- class email.message.EmailMessage(policy=default)¶
Если задана policy, используйте указанные в ней правила для обновления и сериализации представления сообщения. Если policy не задана, используется политика
default
, которая следует правилам почтовых RFC, за исключением окончаний строк (вместо предписанных RFC\r\n
используются стандартные для Python окончания строк\n
). Для получения дополнительной информации см. документациюpolicy
.- as_string(unixfrom=False, maxheaderlen=None, policy=None)¶
Возвращает все сообщение, сглаженное в виде строки. Если необязательное значение unixfrom равно true, заголовок конверта будет включен в возвращаемую строку. Значение unixfrom по умолчанию равно
False
. Для обратной совместимости с базовым классомMessage
принимается значение maxheaderlen, но по умолчанию оно равноNone
, что означает, что по умолчанию длина строки контролируетсяmax_line_length
политики. Аргумент policy может быть использован для переопределения политики по умолчанию, полученной от экземпляра сообщения. Это может быть использовано для управления некоторым форматированием, производимым методом, поскольку указанная политика будет передана вGenerator
.Сплющивание сообщения может вызвать изменения в
EmailMessage
, если необходимо заполнить значения по умолчанию для завершения преобразования в строку (например, могут быть созданы или изменены границы MIME).Обратите внимание, что этот метод предоставляется в качестве удобства и может быть не самым удобным способом сериализации сообщений в вашем приложении, особенно если вы имеете дело с несколькими сообщениями. Смотрите
email.generator.Generator
для более гибкого API для сериализации сообщений. Обратите внимание также на то, что этот метод предназначен только для создания сообщений, сериализованных как «7-битные чистые», когдаutf8
равенFalse
, что является значением по умолчанию.Изменено в версии 3.6: поведение по умолчанию, когда maxheaderlen не указан, было изменено с значения по умолчанию 0 на значение по умолчанию max_line_length из политики.
- __str__()¶
Эквивалентно
as_string(policy=self.policy.clone(utf8=True))
. Позволяетstr(msg)
получить строку, содержащую сериализованное сообщение в удобочитаемом формате.Изменено в версии 3.4: метод был изменен на использование
utf8=True
, что позволило получить представление сообщения, похожее на RFC 6531, вместо того, чтобы быть прямым псевдонимом дляas_string()
.
- as_bytes(unixfrom=False, policy=None)¶
Возвращает все сообщение, сплющенное в виде объекта bytes. Если необязательное значение unixfrom равно true, заголовок конверта будет включен в возвращаемую строку. По умолчанию unixfrom принимает значение
False
. Аргумент policy может быть использован для переопределения политики по умолчанию, полученной из экземпляра сообщения. Это может быть использовано для управления некоторым форматированием, производимым методом, поскольку указанная политика будет передана вBytesGenerator
.Сплющивание сообщения может вызвать изменения в
EmailMessage
, если необходимо заполнить значения по умолчанию для завершения преобразования в строку (например, могут быть созданы или изменены границы MIME).Обратите внимание, что этот метод предоставляется в качестве удобства и может быть не самым удобным способом сериализации сообщений в вашем приложении, особенно если вы имеете дело с несколькими сообщениями. Смотрите
email.generator.BytesGenerator
для более гибкого API для сериализации сообщений.
- __bytes__()¶
Эквивалентно
as_bytes()
. Позволяетbytes(msg)
создавать объект bytes, содержащий сериализованное сообщение.
- is_multipart()¶
Возвращает
True
, если полезная нагрузка сообщения представляет собой список объектов sub-EmailMessage
, в противном случае возвращаетFalse
. Еслиis_multipart()
возвращаетFalse
, полезная нагрузка должна быть строковым объектом (который может быть двоичным объектом, закодированным в CTE). Обратите внимание, чтоis_multipart()
, возвращающийTrue
, не обязательно означает, что «msg.get_content_maintype() == „multipart“» вернетTrue
. Например,is_multipart
вернетTrue
, еслиEmailMessage
имеет типmessage/rfc822
.
- set_unixfrom(unixfrom)¶
Устанавливает в заголовке конверта сообщения значение unixfrom, которое должно быть строкой. (Краткое описание этого заголовка см. в
mboxMessage
).
- get_unixfrom()¶
Возвращает заголовок конверта сообщения. По умолчанию принимает значение
None
, если заголовок конверта никогда не устанавливался.
Следующие методы реализуют маппинг-интерфейс для доступа к заголовкам сообщения. Обратите внимание, что между этими методами и обычным интерфейсом отображения (т. е. словарем) есть некоторые семантические различия. Например, в словаре нет дублирующихся ключей, а здесь могут быть дублирующиеся заголовки сообщений. Кроме того, в словарях нет гарантированного порядка ключей, возвращаемых
keys()
, но в объектеEmailMessage
заголовки всегда возвращаются в том порядке, в каком они были в исходном сообщении или в каком они были добавлены к сообщению позже. Любой заголовок, удаленный, а затем вновь добавленный, всегда добавляется в конец списка заголовков.Эти семантические различия являются преднамеренными и направлены на удобство в наиболее распространенных случаях использования.
Обратите внимание, что во всех случаях любой заголовок конверта, присутствующий в сообщении, не включается в интерфейс отображения.
- __len__()¶
Возвращает общее количество заголовков, включая дубликаты.
- __contains__(name)¶
Возвращает
True
, если объект сообщения имеет поле с именем name. Поиск осуществляется без учета регистра, и name не включает двоеточие в конце. Используется для оператораin
. Например:if 'message-id' in myMessage: print('Message-ID:', myMessage['message-id'])
- __getitem__(name)¶
Возвращает значение именованного поля заголовка. Имя не включает разделитель полей двоеточие. Если заголовок отсутствует, возвращается значение
None
; значениеKeyError
не возвращается.Обратите внимание, что если именованное поле встречается в заголовках сообщения более одного раза, то какое именно из значений этого поля будет возвращено, не определено. Используйте метод
get_all()
, чтобы получить значения всех имеющихся заголовков с именем name.При использовании стандартных (не``compat32``) политик возвращаемое значение является экземпляром подкласса
email.headerregistry.BaseHeader
.
- __setitem__(name, val)¶
Добавляет в сообщение заголовок с именем поля name и значением val. Поле добавляется в конец существующих заголовков сообщения.
Обратите внимание, что при этом не перезаписываются или удаляются существующие заголовки с тем же именем. Если вы хотите, чтобы новый заголовок был единственным, присутствующим в сообщении с именем поля name, сначала удалите это поле, например:
del msg['subject'] msg['subject'] = 'Python roolz!'
Если в
policy
определено, что некоторые заголовки должны быть уникальными (как это делают стандартные политики), этот метод может выдать ошибкуValueError
при попытке присвоить значение такому заголовку, когда он уже существует. Такое поведение намеренно для обеспечения согласованности, но не стоит полагаться на него, поскольку в будущем мы можем решить сделать так, чтобы такие присваивания приводили к автоматическому удалению существующего заголовка.
- __delitem__(name)¶
Удаляет все вхождения поля с именем name из заголовков сообщения. Если именованное поле не присутствует в заголовках, исключение не возникает.
- keys()¶
Возвращает список имен всех полей заголовков сообщения.
- values()¶
Возвращает список всех значений полей сообщения.
- items()¶
Возвращает список из 2 кортежей, содержащих все заголовки и значения полей сообщения.
- get(name, failobj=None)¶
Возвращает значение именованного поля заголовка. Это идентично
__getitem__()
, за исключением того, что необязательное значение failobj возвращается, если именованный заголовок отсутствует (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'))
- replace_header(_name, _value)¶
Заменить заголовок. Заменяет первый найденный в сообщении заголовок, который соответствует _имя, сохраняя порядок заголовков и регистр имен полей исходного заголовка. Если подходящего заголовка не найдено, выдает сообщение
KeyError
.
- get_content_type()¶
Возвращает тип содержимого сообщения, принудительно приведенный к нижнему регистру в виде maintype/subtype. Если в сообщении нет заголовка Content-Type, возвращается значение, возвращаемое командой
get_default_type()
. Если заголовок Content-Type недействителен, возвращаетсяtext/plain
.(Согласно 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_content_type
только в том случае, если в сообщении нет заголовка Content-Type.
- set_param(param, value, header='Content-Type', requote=True, charset=None, language='', replace=False)¶
Устанавливает параметр в заголовке Content-Type. Если параметр уже существует в заголовке, замените его значение на value. Если header имеет значение
Content-Type
(по умолчанию) и заголовок еще не существует в сообщении, добавьте его, установите его значение в text/plain и добавьте новое значение параметра. Необязательный параметр header задает альтернативный заголовок Content-Type.Если значение содержит символы, отличные от ASCII, кодовая сетка и язык могут быть явно указаны с помощью необязательных параметров charset и language. Необязательный параметр language задает язык RFC 2231, по умолчанию - пустую строку. И charset, и language должны быть строками. По умолчанию используется
utf8
charset иNone
для language.Если replace равно
False
(по умолчанию), заголовок будет перемещен в конец списка заголовков. Если replace равноTrue
, заголовок будет обновлен на месте.Использование параметра requote с объектами
EmailMessage
устарело.Обратите внимание, что доступ к существующим значениям параметров заголовков можно получить через атрибут
params
значения заголовка (например,msg['Content-Type'].params['charset']
).Изменено в версии 3.4: Было добавлено ключевое слово
replace
.
- del_param(param, header='content-type', requote=True)¶
Полностью удаляет заданный параметр из заголовка Content-Type. Заголовок будет переписан на место без параметра или его значения. Необязательный параметр header задает альтернативу Content-Type.
Использование параметра requote с объектами
EmailMessage
устарело.
- 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. Если объект сообщения не имеет заголовка Content-Type, возникает ошибкаHeaderParseError
.Обратите внимание, что использование этого метода мало чем отличается от удаления старого заголовка Content-Type и добавления нового с новой границей через
add_header()
, посколькуset_boundary()
сохраняет порядок заголовка Content-Type в списке заголовков.
- get_content_charset(failobj=None)¶
Возвращает параметр
charset
заголовка Content-Type, приведенный к нижнему регистру. Если заголовок Content-Type отсутствует или у него нет параметраcharset
, возвращается failobj.
- get_charsets(failobj=None)¶
Возвращает список, содержащий имена наборов символов в сообщении. Если сообщение является multipart, то список будет содержать по одному элементу для каждого подраздела в полезной нагрузке, в противном случае это будет список длины 1.
Каждый элемент в списке будет строкой, которая является значением параметра
charset
в заголовке Content-Type для представленного подраздела. Если подраздел не имеет заголовка Content-Type, параметраcharset
или не относится к основному MIME-типу text, то этот элемент в возвращаемом списке будет failobj.
- is_attachment()¶
Возвращает
True
, если есть заголовок Content-Disposition и его значение (без учета регистра) равноattachment
,False
в противном случае.Изменено в версии 3.4.2: is_attachment теперь является методом, а не свойством, для согласованности с
is_multipart()
.
- get_content_disposition()¶
Возвращает значение (без параметров) заголовка Content-Disposition сообщения, если он есть, или
None
. Возможные значения для этого метода: inline, attachment илиNone
, если сообщение следует за RFC 2183.Added in version 3.5.
Следующие методы относятся к опросу и манипулированию содержимым (полезной нагрузкой) сообщения.
- walk()¶
Метод
walk()
- это универсальный генератор, который можно использовать для итерации по всем частям и подчастям дерева объектов сообщений в порядке обхода в глубину. Обычно вы используетеwalk()
в качестве итератора в циклеfor
; каждая итерация возвращает следующую подчасть.Вот пример, который выводит MIME-тип каждой части многокомпонентной структуры сообщения:
>>> 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
для отладки:>>> from email.iterators import _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
спускается в слагаемые.
- get_body(preferencelist=('related', 'html', 'plain'))¶
Возвращает часть MIME, которая является наилучшим кандидатом на роль «тела» сообщения.
preferencelist должен быть последовательностью строк из множества
related
,html
иplain
, и указывает порядок предпочтений для типа содержимого возвращаемой части.Начните поиск кандидатов на совпадение с объектом, на котором вызван метод
get_body
.Если
related
не включен в preferencelist, рассматривайте корневую часть (или подчасть корневой части) любой встреченной связи как кандидата, если эта (под-)часть соответствует предпочтению.При встрече с
multipart/related
проверьте параметрstart
и, если найдена часть с совпадающим Content-ID, учитывайте только ее при поиске кандидатов на совпадение. В противном случае рассматривается только первая (по умолчанию корневая) частьmultipart/related
.Если часть имеет заголовок Content-Disposition, считайте часть кандидатом на совпадение, только если значение заголовка равно
inline
.Если ни один из кандидатов не соответствует ни одному из предпочтений в preferencelist, верните
None
.Примечания: (1) Для большинства приложений единственными комбинациями preferencelist, которые действительно имеют смысл, являются
('plain',)
,('html', 'plain')
и('related', 'html', 'plain')
по умолчанию. (2) Поскольку поиск начинается с объекта, для которого вызываетсяget_body
, вызовget_body
наmultipart/related
вернет сам объект, если preferencelist не имеет значения по умолчанию. (3) Сообщения (или части сообщений), в которых не указан Content-Type или заголовок Content-Type которых недействителен, будут рассматриваться как имеющие типtext/plain
, что может иногда приводить к неожиданным результатамget_body
.
- iter_attachments()¶
Возвращает итератор по всем непосредственным вложенным частям сообщения, которые не являются частями «тела» кандидата. То есть, пропустите первое вхождение каждого из
text/plain
,text/html
,multipart/related
илиmultipart/alternative
(если они явно не помечены как вложения через Content-Disposition: attachment), и верните все оставшиеся части. При прямом применении кmultipart/related
возвращает итератор по всем связанным частям, кроме корневой (т. е. части, на которую указывает параметрstart
, или первой части, если параметрstart
отсутствует или параметрstart
не совпадает с Content-ID ни одной из частей). При непосредственном применении кmultipart/alternative
или не``multipart`` возвращает пустой итератор.
- iter_parts()¶
Возвращает итератор по всем непосредственным вложенным частям сообщения, который будет пуст для сообщений, не являющихся``multipart`` (см. также
walk()
).
- get_content(*args, content_manager=None, **kw)¶
Вызовите метод
get_content()
менеджера content_manager, передавая self в качестве объекта сообщения и передавая любые другие аргументы или ключевые слова в качестве дополнительных аргументов. Если content_manager не указан, используйтеcontent_manager
, указанный текущимpolicy
.
- set_content(*args, content_manager=None, **kw)¶
Вызовите метод
set_content()
менеджера content_manager, передавая self в качестве объекта сообщения и передавая любые другие аргументы или ключевые слова в качестве дополнительных аргументов. Если content_manager не указан, используйтеcontent_manager
, указанный текущимpolicy
.
Преобразуйте сообщение, не являющееся
multipart
, в сообщениеmultipart/related
, перемещая все существующие заголовки Content- и полезную нагрузку в (новую) первую частьmultipart
. Если указано boundary, используйте его в качестве строки границы в многочастном сообщении, в противном случае оставьте границу для автоматического создания, когда она потребуется (например, при сериализации сообщения).
- make_alternative(boundary=None)¶
Преобразуйте не``multipart`` или
multipart/related
вmultipart/alternative
, перемещая все существующие заголовки Content- и полезную нагрузку в (новую) первую частьmultipart
. Если указано boundary, используйте его в качестве строки границы в многочастичном сообщении, в противном случае оставьте границу для автоматического создания, когда она потребуется (например, при сериализации сообщения).
- make_mixed(boundary=None)¶
Преобразуйте сообщение, не являющееся
multipart
,multipart/related
илиmultipart-alternative
, вmultipart/mixed
, перемещая все существующие заголовки Content- и полезную нагрузку в (новую) первую частьmultipart
. Если указано boundary, используйте его в качестве строки границы в многочастном сообщении, в противном случае оставьте границу для автоматического создания, когда она понадобится (например, при сериализации сообщения).
Если сообщение является
multipart/related
, создайте новый объект message, передайте все аргументы в его методset_content()
иattach()
его вmultipart
. Если сообщение не являетсяmultipart
, вызовитеmake_related()
, а затем действуйте, как описано выше. Если сообщение является любым другим типомmultipart
, вызовитеTypeError
. Если content_manager не указан, используйтеcontent_manager
, указанный текущимpolicy
. Если добавляемая часть не имеет заголовка Content-Disposition, добавьте заголовок со значениемinline
.
- add_alternative(*args, content_manager=None, **kw)¶
Если сообщение - это
multipart/alternative
, создайте новый объект message, передайте все аргументы в его методset_content()
иattach()
его вmultipart
. Если сообщение не являетсяmultipart
илиmultipart/related
, вызовитеmake_alternative()
, а затем действуйте, как описано выше. Если сообщение является любым другим типомmultipart
, вызовитеTypeError
. Если content_manager не указан, используйтеcontent_manager
, указанный текущимpolicy
.
- add_attachment(*args, content_manager=None, **kw)¶
Если сообщение - это
multipart/mixed
, создайте новый объект message, передайте все аргументы в его методset_content()
иattach()
его вmultipart
. Если сообщение не являетсяmultipart
,multipart/related
илиmultipart/alternative
, вызовитеmake_mixed()
, а затем действуйте, как описано выше. Если content_manager не указан, используйтеcontent_manager
, указанный текущимpolicy
. Если добавляемая часть не имеет заголовка Content-Disposition, добавьте его со значениемattachment
. Этот метод можно использовать как для явных вложений (Content-Disposition: attachment), так и дляinline
вложений (Content-Disposition: inline), передавая соответствующие параметры вcontent_manager
.
- clear()¶
Удалите полезную нагрузку и все заголовки.
- clear_content()¶
Удалите полезную нагрузку и все заголовки !Content-, оставив все остальные заголовки нетронутыми и в их первоначальном порядке.
Объекты
EmailMessage
имеют следующие атрибуты экземпляра:- preamble¶
Формат MIME-документа допускает наличие некоторого текста между пустой строкой, следующей за заголовками, и первой многочастной граничной строкой. Обычно этот текст никогда не виден в программе чтения почты с поддержкой MIME, поскольку он выходит за рамки стандартных MIME-броней. Однако при просмотре необработанного текста сообщения или при просмотре сообщения в программе чтения, не поддерживающей MIME, этот текст может стать видимым.
Атрибут preamble содержит этот ведущий дополнительный текст для документов MIME. Когда
Parser
обнаруживает некоторый текст после заголовков, но до первой граничной строки, он присваивает этот текст атрибуту preamble сообщения. КогдаGenerator
записывает обычное текстовое представление MIME-сообщения и обнаруживает, что в сообщении есть атрибут preamble, он записывает этот текст в область между заголовками и первой граничной строкой. Подробности см. вemail.parser
иemail.generator
.Обратите внимание, что если объект сообщения не имеет преамбулы, атрибут preamble будет равен
None
.
- epilogue¶
Атрибут epilogue действует так же, как и атрибут preamble, за исключением того, что он содержит текст, который появляется между последней границей и концом сообщения. Как и в случае с
preamble
, если текст эпилога отсутствует, этот атрибут будет равенNone
.
- defects¶
Атрибут defects содержит список всех проблем, обнаруженных при разборе этого сообщения. Подробное описание возможных дефектов разбора см. в
email.errors
.
- class email.message.MIMEPart(policy=default)¶
Этот класс представляет подчасть сообщения MIME. Он идентичен
EmailMessage
, за исключением того, что при вызовеset_content()
не добавляются заголовки MIME-Version, поскольку подразделам не нужны собственные заголовки MIME-Version.
Сноски