This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# `email.message`: Representando un mensaje de correo electrónico

Código fuente: Lib/email/message.py

Nuevo en la versión 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.

La interfaz tipo diccionario de `EmailMessage` está indexada por los nombres de las cabeceras, que deberán ser valores ASCII. Los valores del diccionario son cadenas con algunos métodos adicionales. Las cabeceras son almacenadas y retornadas de forma sensible a mayúsculas, pero los nombres de los campos son comparados sin discriminar entre mayúsculas. A diferencia de un dict real, las llaves están ordenadas y pueden estar duplicadas. Se proveen métodos adicionales para trabajar con cabeceras que tienen llaves duplicadas.

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 del `policy`.

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

    Retorna el mensaje entero como cadena de caracteres. Cuando la opción unixform es verdadera, la cabecera está incluida en la cadena de caracteres retornada. unixform está predeterminado con valor `False`. Por compatibilidad con versiones anteriores, la base `Message`, la case maxheaderlen es aceptada pero con valor `None` como predeterminado, por lo que la longitud de línea se controla mediante `max_line_length`. El argumento policy puede ser usado para anular 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á a `Generator`.

    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» cuando `utf8` es `False`, 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))`. Permite `str(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 de `as_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á a `Generator`.

    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__`()

    Equivalente a `as_bytes()`. Permite `bytes(msg)` para producir un objeto byte que contenga el mensaje serializado.

  `is_multipart`()

    Retorna `True` si la carga útil del mensaje es una lista de objetos de sub-`EmailMessage`, de otra manera retorna `False`. Cuando `is_multipart()` retorna `False`, la carga útil deberá ser un objeto cadena de caracteres (que podría ser una carga útil binaria codificada con CTE). Note que si `is_multipart()` retorna `True` no necesariamente significa que «msg.get_content_maintype() == “multipart”» retornará `True`. Por ejemplo, `is_multipart` retornará `True` cuando la `EmailMessage` sea del tipo `message/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 objeto `EmailMessage`, 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 operador `in` 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`, un `KeyError` 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!'

    Si el `policy` define ciertas cabeceras para ser únicos(como lo hace el standard), este método puede generar un `ValueError` cuando se intenta asignar un valor a una cabecera preexistente. Este comportamiento es intencional por consistencia, pero no dependa de ello, ya que podemos optar por hacer que tales asignaciones eliminen la cabecera en el futuro.

  `__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)

    Retorna el valor de la cabecera nombrada. Esto es idéntico a `__getitem__()` excepto que el opcional failobj es retornado si no se encuentra la cabecera nombrada (failobj es por defecto `None`).

  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 sea `None`, 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)`, donde `CHARSET` es una string llamando al charset usado para codificar el valor, `LANGUAJE` generalmente se establece en `None` o en una cadena de caracteres vacía (consulte RFC 2231 para más opciones), y `VALUE` 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, usando `CHARSET` de `utf-8` y `LANGUAJE` `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, retorna `text/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 y `None` para language.

    Si replace es `False` (predeterminado) la cabecera se mueve al final de la lista de cabeceras. Si replace es `True`, la cabecera se actualizará en su lugar.

    El uso del parámetro requote con objetos `EmailMessage` está obsoleto.

    Tenga en cuenta que se puede acceder a los parámetros existentes de las cabeceras a través del atributo `params` de la cabecera (por ejemplo, `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ámetro `filename`, este método recae a buscar el parámetro `name` en la cabecera Content-Type. Si ninguno se encuentra o falta la cabecera, se retorna failobj. La cadena retornada siempre estará sin comillas según `email.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ámetro `boundary`. La cadena retornada siempre estará sin comillas según `email.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 lanza `HeaderParseError`.

    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()`, porque `set_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ámetro `charset`, 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ámetro `charset`, 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) es `attachment`, de lo contrario retorna `False`.

    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 o `None` si el mensaje sigue RFC 2183.

    Nuevo en la versión 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ía `walk()` como el iterador en un ciclo `for`; 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 donde `is_multipart()` retorna `True`, aun si `msg.get_content_maintype() == 'multipart'` pueda retornar `False`. 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 son `multiparts`, pero sí contienen subpartes. `is_multipart()``retorna ``True` y `walk` 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`, y `plain`, 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ámetro `start` 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 la `multipart/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 a `get_body`, llamar a `get_body` en un `multipart/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 tipo `text/plain`, que ocasionalmente puede ocasionar que `get_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`, o `multipart/alternative``(a menos que estén marcados explícitamente como adjuntos a través de :mailheader:`Content-Disposition: attachment`) y retornar todas las partes restantes. Cuando se aplica directamente a un ``multipart/related`, retorna un iterador sobre todas las partes relacionadas excepto la parte raíz (es decir, la parte apuntada por el parámetro `start` , o la primera parte si no hay un parámetro `start` o el parámetro `start` no coincide con el Content-ID de ninguna de las partes). Cuando se aplica directamente a un `multipart/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én `walk()`.)

  `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 el `content_manager` especificado por la `policy` 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 el `content_manager` especificado por la `policy` actual.

  `make_related`(boundary=None)

    Convierte un mensaje no-`multipart` a un mensaje `multipart/related`, moviendo cualquier cabecera Content- y la carga útil a una (nueva) primera parte del `multipart`. 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 mensaje `multipart/related` a uno `multipart/alternative``moviendo cualquier cabecera :mailheader:`Content-` y la carga útil existentes a una (nueva) primera parte del ``multipart`. 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` o `multipart-alternative` a uno `multipart/mixed` moviendo cualquier cabecera Content- y la carga útil existentes a una (nueva) primera parte del `multipart`. 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).

  `add_related`(*args, content_manager=None, **kw)

    Si el mensaje es un `multipart/related`, crea un nuevo objeto mensaje, pasa todos los argumentos a su método `set_content()` y lo une al `multipart` con `attach()`. Si el mensaje es un no-`multipart`, llama a `make_related()` y procede como arriba. Si el mensaje es cualquier otro tipo de `multipart`, lanza `TypeError`. Si content_manager no es especificado, usa el `content_manager` especificado por la `policy` actual. Si la parte agregada no tiene un encabezado Content-Disposition, se agrega uno con el valor `inline`.

  `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étodo `set_content()` y lo une al `multipart` con `attach()`. Si el mensaje es un no-`multipart` o `multipart/related`, llama a `make_alternative()` y procede como arriba. Si el mensaje es cualquier otro tipo de `multipart`, lanza `TypeError`. Si content_manager no es especificado, usa el `content_manager` especificado por la `policy` 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étodo `set_content()` y `attach()` al `multipart`. Si el mensaje no es `multipart`, `multipart/related` o `multipart/alternative`, llame `make_mixed()` y luego proceda como se indicó anteriormente. Si no se especifica content_manager, use el `content_manager` especificado por el actual `policy`. Si la parte agregada no tiene encabezado Content-Disposition, agregue uno con el valor `attachment`. Este método se puede utilizar tanto para adjuntos explícitos (Content-Disposition: attachment) como para adjuntos `inline` (Content-Disposition: inline), pasando las opciones apropiadas al `content_manager`.

  `clear`()

    Elimina la carga útil y todas las cabeceras.

  `clear_content`()

    Elimina la carga útil y todos los `Content-` headers, dejando a las demás cabeceras intactas y en su orden original.

  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 el `Generator` 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éase `email.parser` y `email.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 a `set_content()`, ya que las subpartes no necesitan su propia cabecera MIME-Version.

Notas al pie

1

  Añadido originalmente en la versión 3.4 como un módulo provisional. La documentación para la clase heredada message se movió a email.message.Message: Representar un mensaje de correo electrónico usando la API compat32.