email.message
: Representing an email message¶
Código fuente: Lib/email/message.py
Added in version 3.6: [1]
La clase central en el paquete de email
es la clase EmailMessage
, importada desde el módulo email.message
. Esta es la clase base para el modelo de objeto email
. EmailMessage
provee la funcionalidad clave para configurar y consultar las cabeceras, para acceder al cuerpo del mensaje, y para crear o modificar la estructura del mensaje.
Un mensaje de correo electrónico consiste en headers y un payload (al que también nos referimos como content). Headers como RFC 5322 o RFC 6532 son nombres de campos de estilo y valores, donde el nombre y valor están separados por un “:”. Los dos puntos no son parte ni del nombre ni del valor. El payload puede ser un simple mensaje, un objeto binario, o una secuencia estructurada de sub-mensajes, cada uno con su propio conjunto de headers y su propio payload. El último tipo de payload es indicado por el mensaje con un MIME como multipart/* o message/rfc822 .
El modelo conceptual provisto por un objeto EmailMessage
es el de un diccionario ordenado de cabeceras emparejadas con una carga útil que representa al cuerpo del mensaje RFC 5322, que podría ser una lista de objetos sub-EmailMessage
. Además de los métodos normales de diccionario para acceder a las cabeceras y valores, tiene métodos para acceder a información especializada desde las cabeceras (por ejemplo, el tipo de contenido MIME), para operar en la carga útil, generar una versión serializada del mensaje, y recorrer recursivamente el árbol de objetos.
The EmailMessage
dictionary-like interface is indexed by the header
names, which must be ASCII values. The values of the dictionary are strings
with some extra methods. Headers are stored and returned in case-preserving
form, but field names are matched case-insensitively. The keys are ordered,
but unlike a real dict, there can be duplicates. Additional methods are
provided for working with headers that have duplicate keys.
La carga útil es un objeto de cadena de caracteres o bytes, en el caso de objetos de mensaje simples, o una lista de objetos EmailMessage
, para documentos de contenedor MIME como multipart/* y objetos de mensaje message/rfc822.
- class email.message.EmailMessage(policy=default)¶
Si se especifica policy, use las reglas especificadas para actualizar y serializar la representación del mensaje. Si la política no es establecida, use
default
, que sigue las reglas RFC de email excepto para el fin de línea(en lugar del RFC\r\n
, usa los finales estándar de Python\n
como final de línea). Para más información ve a la documentación delpolicy
.- as_string(unixfrom=False, maxheaderlen=None, policy=None)¶
Return the entire message flattened as a string. When optional unixfrom is true, the envelope header is included in the returned string. unixfrom defaults to
False
. For backward compatibility with the baseMessage
class maxheaderlen is accepted, but defaults toNone
, which means that by default the line length is controlled by themax_line_length
of the policy. The policy argument may be used to override the default policy obtained from the message instance. This can be used to control some of the formatting produced by the method, since the specified policy will be passed to theGenerator
.Aplanar el mensaje puede acarrear cambios en
EmailMessage
si es necesario rellenar los valores predeterminados para completar la transformación a una cadena de caracteres (por ejemplo, se pueden generar o modificar límites MIME).Tenga en cuenta que este método se proporciona como una comodidad y quizás no sea la forma más eficiente de serializar mensajes en su aplicación, especialmente si estás tratando con múltiples mensajes. Consulte
Generator
por una API más flexible para serializar mensajes. No olvide también que este método está restringido a producir mensajes serializados como «7 bit clean» cuandoutf8
esFalse
, que es el valor predeterminado.Distinto en la versión 3.6: el comportamiento predeterminado cuando maxheaderlen no está especificado cambió de 0 al valor de max_line_length de la política .
- __str__()¶
Equivalente a
as_string(policy=self.policy.clone(utf8=True))
. Permitestr(msg)
para producir una cadena que contenga un mensaje serializado en un formato legible.Distinto en la versión 3.4: el método se cambió para usar
utf8=True
, produciendo así un RFC 6531 como representación del mensaje, en vez de ser un alias deas_string()
.
- as_bytes(unixfrom=False, policy=None)¶
Retorna el mensaje plano como un objeto de bytes. Cuando unixform es verdadero, la cabecera es incluida en la cadena de caracteres retornada. El valor predeterminado de unixform es
False
. El argumento policy puede ser usado para sobreescribir el valor predeterminado obtenido de la instancia del mensaje. Esto puede ser usado para controlar parte del formato producido por el método, ya que la política especificada pasará aGenerator
.Aplanar el mensaje puede acarrear cambios en
EmailMessage
si es necesario rellenar los valores predeterminados para completar la transformación a una cadena de caracteres (por ejemplo, se pueden generar o modificar límites MIME).Tenga en cuenta que este método se proporciona como una comodidad y quizás no sea la forma más eficiente de serializar mensajes en su aplicación, especialmente si estas tratando con múltiples mensajes. Consulte
Generator
por una API más flexible para serializar mensajes.
- __bytes__()¶
Equivalent to
as_bytes()
. Allowsbytes(msg)
to produce a bytes object containing the serialized message.
- is_multipart()¶
Retorna
True
si la carga útil del mensaje es una lista de objetos de sub-EmailMessage
, de otra manera retornaFalse
. Cuandois_multipart()
retornaFalse
, la carga útil deberá ser un objeto cadena de caracteres (que podría ser una carga útil binaria codificada con CTE). Note que siis_multipart()
retornaTrue
no necesariamente significa que «msg.get_content_maintype() == “multipart”» retornaráTrue
. Por ejemplo,is_multipart
retornaráTrue
cuando laEmailMessage
sea del tipomessage/rfc822
.
- set_unixfrom(unixfrom)¶
Configura la cabecera del mensaje a unixform, que debería ser una cadena de caracteres. (Consulte
mboxMessage
para una descripción de esta cabecera)
- get_unixfrom()¶
Retorna la cabecera del mensaje. Predeterminado
None
si la cabecera no ha sido configurada.
Los siguientes métodos implementan el mapeo como una interfaz para acceder a la cabecera del mensaje. Tenga en cuenta que hay algunas diferencias semánticas entre esos métodos y una interfaz de mapeo normal(es decir, diccionario). Por ejemplo, en un diccionario no hay claves duplicadas, pero pueden haber cabeceras duplicadas. Además, en los diccionarios no hay un orden garantizado para las claves retornadas por
keys()
, pero en un objetoEmailMessage
, las cabeceras siempre regresan en orden de aparición en el mensaje original, o en el que fueron agregadas luego. Cualquier cabecera borrada y vuelta a añadir siempre se agrega al final de la lista.Estas diferencias semánticas son intencionales y están sesgadas hacia la conveniencia en los casos de uso más comunes.
Note que en todos los casos, cualquier cabecera presente en el mensaje no se incluye en la interfaz de mapeo.
- __len__()¶
Retorna el número total de cabeceras, incluidas las duplicadas.
- __contains__(name)¶
Retorna
True
si el objeto del mensaje tiene un campo llamado “nombre”. La comparación se realiza sin tener en cuenta mayúsculas o minúsculas y “nombre” no incluye “:”. Se utiliza para el operadorin
Por ejemplo:if 'message-id' in myMessage: print('Message-ID:', myMessage['message-id'])
- __getitem__(name)¶
Retorna el valor de la cabecera nombrada. name no incluye el separador de dos puntos, “:”. Si la cabecera se pierde, regresa
None
, unKeyError
no se genera nunca.Tenga en cuenta que si el campo nombrado aparece más de una vez en la cabecera del mensaje, esa cantidad de veces el valor regresado será indefinido. Use el método
get_all()
para obtener los valores de todas las cabeceras existentes llamadas name.Usando el standard non-“compat32”, el valor regresado es una instancia de una subclase de
email.headerregistry.BaseHeader
.
- __setitem__(name, val)¶
Agrega una cabecera al mensaje con un campo “nombre” y un valor “val”. El campo se agrega al final de las cabeceras existentes en el mensaje.
Tenga en cuenta que esto no sobrescribe ni borra ninguna cabecera con el mismo nombre. Si quiere asegurarse de que la nueva cabecera es la única en el mensaje con el campo “nombre”, borre el campo primero, por ejemplo:
del msg['subject'] msg['subject'] = 'Python roolz!'
If the
policy
defines certain headers to be unique (as the standard policies do), this method may raise aValueError
when an attempt is made to assign a value to such a header when one already exists. This behavior is intentional for consistency’s sake, but do not depend on it as we may choose to make such assignments do an automatic deletion of the existing header in the future.
- __delitem__(name)¶
Elimine todas las apariciones del campo “nombre” de las cabeceras del mensaje. No se genera ninguna excepción si el campo nombrado no está presente en las cabeceras.
- keys()¶
Retorna una lista de los nombres de todos los campos de la cabecera del mensaje.
- values()¶
Retorna una lista de todos los valores de los campos del mensaje.
- items()¶
Retorna una lista de tuplas de dos elementos que contienen todos los campos cabeceras y valores del mensaje.
- get(name, failobj=None)¶
Return the value of the named header field. This is identical to
__getitem__()
except that optional failobj is returned if the named header is missing (failobj defaults toNone
).
Aquí hay algunos métodos adicionales útiles relacionados con la cabecera:
- get_all(name, failobj=None)¶
Retorna una lista de todos los valores para el campo nombre. Si no se nombran tales cabeceras en el mensaje, regresa failobj (por defecto
None
)
- add_header(_name, _value, **_params)¶
Configuración extendida de cabeceras. Este método es similar a
__setitem__()
, excepto que se pueden proporcionar parámetros de cabecera adicionales como argumentos de palabras clave.Por cada ítem en los parámetros del diccionario _params, la clave se toma como el nombre del parámetro, con barra baja (“_”) convertidos a guiones (“-”) (ya que en Python no se permiten “-” como identificadores). Normalmente, el parámetro debe ser añadido como
key='value'
a menos que el valor seaNone
, en ese caso solo la clave debe ser añadida.Si el valor contiene caracteres no-ASCII, el charset y el lenguaje deben ser controlados especificando el valor como una triple tupla en formato
(CHARSET, LANGUAJE, VALUE)
, dondeCHARSET
es una string llamando al charset usado para codificar el valor,LANGUAJE
generalmente se establece enNone
o en una cadena de caracteres vacía (consulte RFC 2231 para más opciones), yVALUE
es el valor de la cadena de caracteres que contiene puntos de código no-ASCII. Si la triple tupla no pasa y el valor contiene caracteres no-ASCII, es automáticamente codificada en formato RFC 2231, usandoCHARSET
deutf-8
yLANGUAJE
None
.Aquí hay un ejemplo:
msg.add_header('Content-Disposition', 'attachment', filename='bud.gif')
Esto agregará una cabecera que se ve como:
Content-Disposition: attachment; filename="bud.gif"
Un ejemplo de la interfaz extendida con caracteres no-ASCII:
msg.add_header('Content-Disposition', 'attachment', filename=('iso-8859-1', '', 'Fußballer.ppt'))
- replace_header(_name, _value)¶
Reemplaza una cabecera. Reemplaza la primer cabecera encontrada en el mensaje que coincida con _name, conservando el orden de cabeceras y uso de minúsculas (y mayúsculas) del nombre de campo de la cabecera original. Si no hay coincidencia, se lanzará un
KeyError
.
- get_content_type()¶
Retorna el tipo de contenido del mensaje, pasado a minúsculas de la forma maintype/subtype. Si no hay cabecera llamada Content-Type en el mensaje, regresa el valor de
get_default_type()
. Si Content-Type no es válido, retornatext/plain
.(De acuerdo con RFC 2045, los mensajes siempre tienen un tipo predeterminado,
get_content_type`siempre retornará un valor. :rfc:`2045`define el tipo predeterminado de un mensaje como :mimetype:`text/plain()
a menos que aparezca dentro de un contenedor multipart/digest, en cuyo caso sería message/rfc822. Si la cabecera Content-Type tiene una especificación de tipo que sea inválida, RFC 2045 exige que el tipo predeterminado sea text/plain.)
- get_content_maintype()¶
Retorna el tipo de contenido principal del mensaje. Esta es la parte maintype de la cadena retornada por
get_content_type()
.
- get_content_subtype()¶
Retorna el tipo del sub-contenido del mensaje. Esta es la parte subtype de la cadena retornada por
get_content_type()
.
- get_default_type()¶
Retorna el tipo de contenido predeterminado. La mayoría de los mensajes tienen como tipo de contenido predeterminado a text/plain, a excepción de los mensajes que son sub-partes de contenedores multipart/digest. Estas sub-partes tienen como tipo de contenido predeterminado a message/rfc822.
- set_default_type(ctype)¶
Establece el tipo de contenido predeterminado. ctype debería ser text/plain o message/rfc822, aunque esto no está impuesto. El tipo de contenido predeterminado no se almacena en la cabecera Content-Type, así que sólo afecta al valor de retorno de los métodos
get_content_type
cuando ninguna cabecera Content-Type está presente en el mensaje.
- set_param(param, value, header='Content-Type', requote=True, charset=None, language='', replace=False)¶
Establece un parámetro en el encabezado Content-Type. Si el parámetro ya existe en el encabezado, reemplace su valor con value. Cuando header es
Content-Type
(el predeterminado) y el encabezado aún no existe en el mensaje, agréguelo, establece su valor en text/plain y agregue el nuevo valor del parámetro. header opcional especifica un encabezado alternativo a Content-Type.Si el valor contiene caracteres non-ASCII, el charset y el lenguaje pueden ser especificados explícitamente con los parámetros charset y language. Opcionalmente language especifica el lenguaje RFC 2231, por defecto una cadena vacía. Ambos charset y language deberán ser cadenas. los valores predeterminados son
utf8
para charset yNone
para language.Si replace es
False
(predeterminado) la cabecera se mueve al final de la lista de cabeceras. Si replace esTrue
, la cabecera se actualizará en su lugar.El uso del parámetro requote con objetos
EmailMessage
está obsoleto.Note that existing parameter values of headers may be accessed through the
params
attribute of the header value (for example,msg['Content-Type'].params['charset']
).Distinto en la versión 3.4: Se agregó la palabra clave
replace
.
- del_param(param, header='content-type', requote=True)¶
Elimina completamente el parámetro dado de la cabecera Content-Type. La cabecera será reescrita en su lugar, sin el parámetro o su valor. Opcionalmente header especifica una alternativa a Content-Type.
El uso del parámetro requote con objetos
EmailMessage
está obsoleto.
- get_filename(failobj=None)¶
Retorna el valor del parámetro
filename
de la cabecera Content-Disposition del mensaje. Si la cabecera no tiene un parámetrofilename
, este método recae a buscar el parámetroname
en la cabecera Content-Type. Si ninguno se encuentra o falta la cabecera, se retorna failobj. La cadena retornada siempre estará sin comillas segúnemail.utils.unquote()
.
- get_boundary(failobj=None)¶
Retorna el parámetro
boundary
de la cabecera Content-Type del mensaje, o failobj si la cabecera no se encuentra o si no tiene un parámetroboundary
. La cadena retornada siempre estará sin comillas segúnemail.utils.unquote()
.
- set_boundary(boundary)¶
Establece el parámetro
boundary
de la cabecera Content-Type como boundary.set_boundary()
siempre que sea necesario pondrá comillas a boundary. Si el objeto mensaje no tiene cabecera Content-Type se lanzaHeaderParseError
.Note que usar este método es sutilmente diferente a borrar la cabecera Content-Type antigua y agregar una nueva con el nuevo límite utilizando
add_header()
, porqueset_boundary()
preserva el orden de la cabecera Content-Type en la lista de cabeceras.
- get_content_charset(failobj=None)¶
Retorna el parámetro
charset
de la cabecera Content-Type`forzado a minúsculas. Si no hay una cabecera :mailheader:`Content-Type, o si esa cabecera no tiene el parámetrocharset
, se retorna failobj.
- get_charsets(failobj=None)¶
Retorna una lista que contiene los nombres de los charset en el mensaje. Si el mensaje es multipart, la lista contendrá un elemento por cada subparte en la carga útil, de lo contrario será una lista de longitud 1.
Cada elemento de la lista será una cadena que tendrá el valor del parámetro
charset
en la cabecera Content-Type para la subparte representada. Si la subparte no tiene cabecera Content-Type, no tiene parámetrocharset
, o no es del tipo MIME principal text, entonces ese elemento en la lista retornada será failobj.
- is_attachment()¶
Retorna
True
si hay una cabecera Content-Disposition y su valor (sensible a mayúsculas) esattachment
, de lo contrario retornaFalse
.Distinto en la versión 3.4.2: is_attachment ahora es un método en lugar de una propiedad, por consistencia con
is_multipart()
.
- get_content_disposition()¶
Retorna el valor en minúsculas (sin parámetros) de la cabecera Content-Disposition si el mensaje la tiene, de lo contrario retorna
None
. Los valores posibles para este método son inline, attachment oNone
si el mensaje sigue RFC 2183.Added in version 3.5.
Los siguientes métodos se refieren a interrogar y manipular el contenido (payload) del mensaje.
- walk()¶
El método
walk()
es un generador multipropósito que puede usarse para iterar sobre todas las partes y subpartes del árbol de un objeto mensaje, ordenando el recorrido en profundidad primero. Típicamente se usaríawalk()
como el iterador en un ciclofor
; cada iteración retornará la siguiente subparte.Aquí hay un ejemplo que imprime el tipo MIME de cada parte de una estructura de mensaje de varias partes:
>>> 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
itera sobre las subpartes de cualquier parte dondeis_multipart()
retornaTrue
, aun simsg.get_content_maintype() == 'multipart'
pueda retornarFalse
. Podemos ver esto en nuestro ejemplo al hacer uso de la función auxiliar de depuración_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
Aquí las partes
message
no sonmultiparts
, pero sí contienen subpartes.is_multipart()
retornaTrue
ywalk
desciende a las subpartes.
- get_body(preferencelist=('related', 'html', 'plain'))¶
Retorna la parte MIME que es la mejor candidata para ser el «cuerpo» del mensaje.
preferencelist debe ser una secuencia de cadenas del conjunto
related
,html
, yplain
, e Indica el orden de preferencia para el tipo de contenido de la parte retornada.Empieza a buscar coincidencias candidatas con el objeto en el que se llama al método
get_body
”.Si
related
no está incluido en la preferencelist, considere la parte raíz (o subparte de la parte raíz) de cualquier relacionado encontrado como candidato si la (sub-)parte coincide con una preferencia.Cuando se encuentra una
multipart/related
, verifica el parámetrostart
y si se encuentra una parte con un Content-ID que coincida, considera solamente a ésta cuando se busca coincidencias candidatas. De otra forma considera sólo la primera parte (predeterminado root) de lamultipart/related
.Si una parte tiene una cabecera Content-Disposition , sólo se considera a ésta parte como coincidencia candidata si el valor de la cabecera es
inline
.Si ninguno de los candidatos coincide con ninguna de las preferencias en preferencelist, retorna
None
.Notas: (1) Para la mayoría de las aplicaciones las únicas combinaciones de preferencelist que realmente tienen sentido son
('plain',)
,('html', 'plain')
, y la predeterminada('related', 'html', 'plain')
. (2) Debido a que la coincidencia comienza con el objeto en el que se llama aget_body
, llamar aget_body
en unmultipart/related
devolverá el objeto en sí a menos que la preferencelist tenga un valor no predeterminado. (3) Los mensajes (o partes de mensajes) que no especifican un Content-Type o cuya cabecera Content-Type sea inválida se tratarán como si fueran del tipotext/plain
, que ocasionalmente puede ocasionar queget_body
retorne resultados inesperados.
- iter_attachments()¶
Devuelve un iterador sobre todas las subpartes inmediatas del mensaje que no son partes candidatas del «body». Es decir, omitir la primer ocurrencia de cada
text/plain
,text/html
,multipart/related
, omultipart/alternative
(a menos que estén marcados explícitamente como adjuntos a través de Content-Disposition: attachment) y retornar todas las partes restantes. Cuando se aplica directamente a unmultipart/related
, retorna un iterador sobre todas las partes relacionadas excepto la parte raíz (es decir, la parte apuntada por el parámetrostart
, o la primera parte si no hay un parámetrostart
o el parámetrostart
no coincide con el Content-ID de ninguna de las partes). Cuando se aplica directamente a unmultipart/alternative
o a un no-multipart
, retorna un iterador vacío.
- iter_parts()¶
Retorna un iterador sobre todas las partes inmediatas del mensaje, que estará vacío para una no-
multipart
. (vea tambiénwalk()
.)
- get_content(*args, content_manager=None, **kw)¶
Llama al método
get_content()
del content_manager, pasando self como el objeto del mensaje y pasando cualquier otro argumento o palabra clave como argumentos adicionales. Si no se especifica content_manager se usa elcontent_manager
especificado por lapolicy
actual.
- set_content(*args, content_manager=None, **kw)¶
Llama al método
set_content()
del content_manager, pasando self como el objeto message y pasando cualquier otro argumento o palabra clave como argumentos adicionales. Si no se especifica content_manager se usa elcontent_manager
especificado por lapolicy
actual.
Convierte un mensaje no-
multipart
a un mensajemultipart/related
, moviendo cualquier cabecera Content- y la carga útil a una (nueva) primera parte delmultipart
. Si boundary se especifica, se utiliza como la cadena límite en el multipart, de otra forma deja que el límite se cree automáticamente cuando se necesite (por ejemplo, cuando se serializa el mensaje).
- make_alternative(boundary=None)¶
Convierte un mensaje no-
multipart
o un mensajemultipart/related
a unomultipart/alternative
moviendo cualquier cabecera Content- y la carga útil existentes a una (nueva) primera parte delmultipart
. Si boundary se especifica, se utiliza como la cadena límite en el multipart, de otra forma deja que el límite se cree automáticamente cuando se necesite (por ejemplo, cuando se serializa el mensaje).
- make_mixed(boundary=None)¶
Convierte un mensaje no-
multipart
,multipart/related
omultipart-alternative
a unomultipart/mixed
moviendo cualquier cabecera Content- y la carga útil existentes a una (nueva) primera parte delmultipart
. Si boundary se especifica, se utiliza como la cadena límite en el multipart, de otra forma deja que el límite se cree automáticamente cuando se necesite (por ejemplo, cuando se serializa el mensaje).
Si el mensaje es un
multipart/related
, crea un nuevo objeto mensaje, pasa todos los argumentos a su métodoset_content()
y lo une almultipart
conattach()
. Si el mensaje es un no-multipart
, llama amake_related()
y procede como arriba. Si el mensaje es cualquier otro tipo demultipart
, lanzaTypeError
. Si content_manager no es especificado, usa elcontent_manager
especificado por lapolicy
actual. Si la parte agregada no tiene un encabezado Content-Disposition, se agrega uno con el valorinline
.
- add_alternative(*args, content_manager=None, **kw)¶
Si el mensaje es un
multipart/alternative
, crea un nuevo objeto mensaje, pasa todos los argumentos a su métodoset_content()
y lo une almultipart
conattach()
. Si el mensaje es un no-multipart
omultipart/related
, llama amake_alternative()
y procede como arriba. Si el mensaje es cualquier otro tipo demultipart
, lanzaTypeError
. Si content_manager no es especificado, usa elcontent_manager
especificado por lapolicy
actual.
- add_attachment(*args, content_manager=None, **kw)¶
Si el mensaje es un
multipart/mixed
, cree un nuevo objeto de mensaje, pase todos los argumentos a su métodoset_content()
yattach()
almultipart
. Si el mensaje no esmultipart
,multipart/related
omultipart/alternative
, llamemake_mixed()
y luego proceda como se indicó anteriormente. Si no se especifica content_manager, use elcontent_manager
especificado por el actualpolicy
. Si la parte agregada no tiene encabezado Content-Disposition, agregue uno con el valorattachment
. Este método se puede utilizar tanto para adjuntos explícitos (Content-Disposition: attachment) como para adjuntosinline
(Content-Disposition: inline), pasando las opciones apropiadas alcontent_manager
.
- clear()¶
Elimina la carga útil y todas las cabeceras.
- clear_content()¶
Remove the payload and all of the !Content- headers, leaving all other headers intact and in their original order.
Los objetos
EmailMessage
tienen los siguientes atributos de instancia:- preamble¶
El formato de un documento MIME permite algo de texto entre la linea en blanco después de las cabeceras y la primera cadena límite de multiparte. Normalmente, este texto nunca es visible en un lector de correo compatible con MIME porque queda fuera de la armadura MIME estándar. Sin embargo, al ver el texto sin formato del mensaje, o al ver el mensaje en un lector no compatible con MIME, este texto puede volverse visible.
El atributo preamble contiene este texto extra para documentos MIME. Cuando el
Parser
descubre texto después de las cabeceras pero antes de la primer cadena límite, asigna este texto al atributo preamble del mensaje. Cuando elGenerator
escribe la representación de texto sin formato de un mensaje MIME y encuentra que el mensaje tiene un atributo preamble escribirá este texto en el área entre las cabeceras y el primer límite. Véaseemail.parser
yemail.generator
para conocer detalles.Cabe señalar que si el objeto message no tiene preámbulo, el atributo preamble será igual a
None
.
- epilogue¶
El atributo epilogue actúa de igual forma al atributo preamble con la excepción de que contiene texto que aparece entre el último límite y el fin del mensaje. Como con el
preamble
, si no hay texto de epílogo este atributo seráNone
.
- defects¶
El atributo defects contiene una lista de todos los errores encontrados al hacer el análisis sintáctico del mensaje. Vea
email.errors
para una descripción detallada de los posibles efectos del análisis sintáctico.
- class email.message.MIMEPart(policy=default)¶
Esta clase representa una subparte de un mensaje MIME. Es idéntica a
EmailMessage
, excepto que las cabeceras MIME-Version son añadidas cuando se llama aset_content()
, ya que las subpartes no necesitan su propia cabecera MIME-Version.
Notas al pie