email.mime
: Creating email and MIME objects from scratch¶
Código fuente: Lib/email/mime/
Este módulo forma parte de la API heredada de correo electrónico (Compat32
). Su funcionalidad se sustituye parcialmente por el contentmanager
en la nueva API, pero en ciertas aplicaciones estas clases pueden seguir siendo útiles, incluso en código no heredado.
Normalmente, se obtiene una estructura de objeto de mensaje pasando un archivo o algún texto a un analizador, que analiza el texto y retorna el objeto de mensaje principal. Sin embargo, también puede crear una estructura de mensajes completa desde cero, o incluso objetos individuales Message
a mano. De hecho, también puede tomar una estructura existente y agregar nuevos objetos Message
, moverlos, etc. Esto compone una interfaz muy conveniente para cortar y gestionar mensajes MIME.
Puede crear una nueva estructura de objeto mediante la creación de una instancia de Message
, añadiendo accesorios y todos los encabezados necesarios manualmente. Para mensajes MIME sin embargo, el paquete email
proporciona subclases convenientes para facilitar las cosas.
Descripción de las clases:
- class email.mime.base.MIMEBase(_maintype, _subtype, *, policy=compat32, **_params)¶
Módulo:
email.mime.base
Esta es la clase básica para todas las subclases específicas
Message
para MIME. Normalmente no creará instancias específicas de laMIMEBase
, aunque es posible. LaMIMEBase
se proporciona principalmente como una clase básica conveniente para subclases más específicas, apropiadas para MIME._maintype es el tipo principal Content-Type (por ejemplo text o image), y _subtype es el tipo menor Content-Type (por ejemplo plain o gif). _params es un diccionario de parámetro clave/valor y se pasa directamente a
Message.add_header
.Si se especifica policy, (por defecto, la directiva
compat32
) se pasará aMessage
.La clase
MIMEBase
siempre agrega un encabezado Content-Type (basado en _maintype, _subtype y _params), y un encabezado MIME-Versión (siempre establecido en1.0
).Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.nonmultipart.MIMENonMultipart¶
Módulo:
email.mime.nonmultipart
Una subclase de
MIMEBase
, es una clase base intermedia para los mensajes MIME que no son multipart. El propósito principal de esta clase es evitar el uso del métodoattach()
, que solo tiene sentido para los mensajes multipart. Si se llama aattach()
, se lanza una excepciónMultipartConversionError
.
- class email.mime.multipart.MIMEMultipart(_subtype='mixed', boundary=None, _subparts=None, *, policy=compat32, **_params)¶
Módulo:
email.mime.multipart
Una subclase de
MIMEBase
, se trata de una clase base intermedia para los mensajes MIME que son multipart. El valor predeterminado opcional de _subtype es mixed, pero se puede utilizar para especificar el subtipo del mensaje. Se agregará un encabezado Content-Type de multipart/_subtype al objeto del mensaje. También se agregará un encabezado MIME-Version.El boundary opcional es la cadena de límite multiparte. Cuando
None
(valor predeterminado), el límite se calcula cuando es necesario (por ejemplo, cuando se serializa el mensaje)._subparts es una secuencia de subpartes iniciales para la carga útil. Debe ser posible convertir esta secuencia en una lista. Siempre puede adjuntar nuevas subpartes al mensaje mediante el método
Message.attach
.El valor predeterminado del argumento policy opcional es
compat32
.Los parámetros adicionales para el encabezado Content-Type se toman de los argumentos de palabra clave, o se pasan al argumento _params, que es un diccionario de palabras clave.
Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.application.MIMEApplication(_data, _subtype='octet-stream', _encoder=email.encoders.encode_base64, *, policy=compat32, **_params)¶
Módulo:
email.mime.application
A subclass of
MIMENonMultipart
, theMIMEApplication
class is used to represent MIME message objects of major type application. _data contains the bytes for the raw application data. Optional _subtype specifies the MIME subtype and defaults to octet-stream._encoder opcional es una recurso invocable (es decir, una función) que realizará la codificación real de los datos para el transporte. Este invocable toma un argumento, que es la instancia
MIMEApplication
. Debe utilizarget_payload()
yset_payload()
para cambiar la carga útil a la forma codificada. También debe agregar cualquier Content-Transfer-Encoding u otros encabezados al objeto del mensaje según sea necesario. La codificación predeterminada es base64. Consulte el móduloemail.encoders
para obtener una lista de los codificadores integrados.El valor predeterminado del argumento policy opcional es
compat32
._params se pasan directamente al constructor de la clase base.
Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.audio.MIMEAudio(_audiodata, _subtype=None, _encoder=email.encoders.encode_base64, *, policy=compat32, **_params)¶
Módulo:
email.mime.audio
A subclass of
MIMENonMultipart
, theMIMEAudio
class is used to create MIME message objects of major type audio. _audiodata contains the bytes for the raw audio data. If this data can be decoded as au, wav, aiff, or aifc, then the subtype will be automatically included in the Content-Type header. Otherwise you can explicitly specify the audio subtype via the _subtype argument. If the minor type could not be guessed and _subtype was not given, thenTypeError
is raised._encoder opcional es un recurso invocable (es decir, una función) que realizará la codificación real de los datos de audio para el transporte. Este invocable toma un argumento, que es la instancia
MIMEAudio
. Debe utilizarget_payload()
yset_payload()
para cambiar la carga útil a la forma codificada. También debe agregar cualquier Content-Transfer-Encoding u otros encabezados al objeto del mensaje según sea necesario. La codificación predeterminada es base64. Consulte el móduloemail.encoders
para obtener una lista de los codificadores integrados.El valor predeterminado del argumento policy opcional es
compat32
._params se pasan directamente al constructor de la clase base.
Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.image.MIMEImage(_imagedata, _subtype=None, _encoder=email.encoders.encode_base64, *, policy=compat32, **_params)¶
Módulo:
email.mime.image
A subclass of
MIMENonMultipart
, theMIMEImage
class is used to create MIME message objects of major type image. _imagedata contains the bytes for the raw image data. If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, pgm, ppm, rast, xbm, bmp, webp, and exr attempted), then the subtype will be automatically included in the Content-Type header. Otherwise you can explicitly specify the image subtype via the _subtype argument. If the minor type could not be guessed and _subtype was not given, thenTypeError
is raised._encoder opcional es un recurso invocable (es decir, una función) que realizará la codificación real de los datos de imagen para el transporte. Este invocable toma un argumento, que es la instancia
MIMEImage
. Debe utilizarget_payload()
yset_payload()
para cambiar la carga útil a la forma codificada. También debe agregar cualquier Content-Transfer-Encoding u otros encabezados al objeto del mensaje según sea necesario. La codificación predeterminada es base64. Consulte el móduloemail.encoders
para obtener una lista de los codificadores integrados.El valor predeterminado del argumento policy opcional es
compat32
._params se pasan directamente al constructor
MIMEBase
.Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.message.MIMEMessage(_msg, _subtype='rfc822', *, policy=compat32)¶
Módulo:
email.mime.message
Una subclase de
MIMENonMultipart
, la claseMIMEMessage
se utiliza para crear objetos MIME de tipo principal message. _msg se utiliza como la carga y debe ser una instancia de la claseMessage
(o una subclase de la misma), de lo contrario se lanza unTypeError
._subtype opcional establece el subtipo del mensaje; por defecto es rfc822.
El valor predeterminado del argumento policy opcional es
compat32
.Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.
- class email.mime.text.MIMEText(_text, _subtype='plain', _charset=None, *, policy=compat32)¶
Módulo:
email.mime.text
Una subclase de
MIMENonMultipart
, la claseMIMEText
se utiliza para crear objetos MIME de tipo principal text. _text es la cadena de caracteres de la carga útil. _subtype es el tipo menor y el valor predeterminado es plain. _charset es el paquete de caracteres del texto y se pasa como argumento al constructorMIMENonMultipart
; el valor predeterminado esus-ascii
si la cadena contiene sólo puntos de códigoascii
, yutf-8
en caso contrario. El parámetro _charset acepta una cadena o una instanciaCharset
.A menos que el argumento _charset se establezca explícitamente como
None
, el objeto MIMEText creado tendrá a la vez un encabezado Content-Type con un parámetrocharset
, y un encabezado Content-Transfer-Encoding. Esto significa que una llamada posterior aset_payload
no dará lugar a una carga codificada, incluso si se pasa un conjunto de caracteres en el comandoset_payload
. Puede «restablecer» este comportamiento eliminando el encabezadoContent-Transfer-Encoding
, después de lo cual una llamada aset_payload
codificará automáticamente la nueva carga útil (y agregará un nuevo encabezado Content-Transfer-Encoding).El valor predeterminado del argumento policy opcional es
compat32
.Distinto en la versión 3.5: _charset también acepta instancias
Charset
.Distinto en la versión 3.6: Se ha añadido el parámetro policy de solo palabra clave.