diff --git a/dictionaries/library_email.compat32-message.txt b/dictionaries/library_email.compat32-message.txt new file mode 100644 index 0000000000..3c64751bd6 --- /dev/null +++ b/dictionaries/library_email.compat32-message.txt @@ -0,0 +1,6 @@ +submensajes +pseudodiccionario +recodificada +defect +subcontenido +multiparte \ No newline at end of file diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index 197a033a0a..ee7215bc04 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -6,25 +6,28 @@ # Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to # get the list of volunteers # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-05-05 12:54+0200\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2020-11-09 21:18+0100\n" +"Last-Translator: Álvaro Mondéjar \n" "Language-Team: python-doc-es\n" +"Language: es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.8.0\n" +"X-Generator: Poedit 2.4.2\n" #: ../Doc/library/email.compat32-message.rst:4 msgid "" ":mod:`email.message.Message`: Representing an email message using the :data:" "`~email.policy.compat32` API" msgstr "" +":mod:`email.message.Message`: Representar un mensaje de correo electrónico " +"usando la API :data:`~email.policy.compat32`" #: ../Doc/library/email.compat32-message.rst:12 msgid "" @@ -35,10 +38,16 @@ msgid "" "message.EmailMessage` class, are not recommended unless you are dealing with " "legacy code." msgstr "" +"La clase :class:`Message` es muy similar a la clase :class:`~email.message." +"EmailMessage`, sin los métodos añadidos por esa clase y con el " +"comportamiento predeterminado de algunos otros métodos siendo ligeramente " +"diferente. También documentamos aquí algunos métodos que, aun siendo " +"soportados por :class:`~email.message.EmailMessage`, no están recomendados a " +"no ser que estés lidiando con código heredado." #: ../Doc/library/email.compat32-message.rst:19 msgid "The philosophy and structure of the two classes is otherwise the same." -msgstr "" +msgstr "Por lo demás, la filosofía y estructura de las dos clases es la misma." #: ../Doc/library/email.compat32-message.rst:21 msgid "" @@ -47,6 +56,10 @@ msgid "" "another policy, you should be using the :class:`~email.message.EmailMessage` " "class instead." msgstr "" +"Este documento describe el comportamiento bajo la política por defecto " +"(para :class:`Message`) :attr:`~email.policy.Compat32`. Si vas a usar otra " +"política, deberías estar usando la clase :class:`~email.message." +"EmailMessage` en su lugar." #: ../Doc/library/email.compat32-message.rst:25 msgid "" @@ -59,6 +72,15 @@ msgid "" "message having a MIME type such as :mimetype:`multipart/\\*` or :mimetype:" "`message/rfc822`." msgstr "" +"Un mensaje de correo electrónico consiste en encabezados (*headers*) y una " +"carga (*payload*). Los encabezados deben seguir el estilo de nombres y " +"valores :rfc:`5233`, donde el nombre del campo y el valor son separados por " +"dos puntos. El carácter de doble punto no es parte ni del nombre del campo " +"ni del valor. La carga puede ser un simple mensaje de texto, un objeto " +"binario o una secuencia de submensajes estructurada, cada uno con su propio " +"conjunto de encabezados y su propia carga. El último tipo de carga se indica " +"por el mensaje teniendo un tipo MIME tal como :mimetype:`multipart/\\*` o :" +"mimetype:`message/rfc822`." #: ../Doc/library/email.compat32-message.rst:34 msgid "" @@ -69,6 +91,13 @@ msgid "" "over the object tree. Note that duplicate headers are supported but special " "methods must be used to access them." msgstr "" +"El modelo conceptual proporcionado por un objeto :class:`Message` es el de " +"un diccionario ordenado de encabezados con métodos adicionales para acceder " +"a información especializada de los encabezados, para acceder a la carga, " +"para generar una versión serializada del mensaje y para recorrer " +"recursivamente el árbol del objeto. Ten en cuenta que son soportados " +"encabezados duplicados pero deben ser usados métodos especiales para acceder " +"a ellos." #: ../Doc/library/email.compat32-message.rst:41 msgid "" @@ -83,10 +112,22 @@ msgid "" "list of :class:`Message` objects, for MIME container documents (e.g. :" "mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." msgstr "" +"El pseudodiccionario :class:`Message` es indexado por los nombres de " +"encabezados, los cuales deben ser valores ASCII. Los valores del diccionario " +"son cadenas que se supone que contienen sólo caracteres ASCII; hay algún " +"manejo especial para la entrada no ASCII, pero esta no siempre produce los " +"resultados correctos. Los encabezados son almacenados y retornados " +"preservando mayúsculas y minúsculas, pero los nombres de campos son " +"emparejados sin distinción entre mayúsculas y minúsculas. También puede " +"haber sólo un encabezado de envoltura, también conocido como el encabezado " +"*Unix-From* o el encabezado ``From_``. La carga (*payload*) es una cadena o " +"bytes, en el caso de objetos de mensajes simples, o una lista de objetos :" +"class:`Message`, para contenedores de documentos MIME (ej. :mimetype:" +"`multipart/\\*` y :mimetype:`message/rfc822`)." #: ../Doc/library/email.compat32-message.rst:52 msgid "Here are the methods of the :class:`Message` class:" -msgstr "" +msgstr "Aquí están los métodos de la clase :class:`Message`:" #: ../Doc/library/email.compat32-message.rst:57 msgid "" @@ -97,10 +138,16 @@ msgid "" "Python 3.2 version of the email package. For more information see the :mod:" "`~email.policy` documentation." msgstr "" +"Si se especifica *policy* (debe ser una instancia de una clase :mod:`~email." +"policy`) utiliza las reglas que especifica para actualizar y serializar la " +"representación del mensaje. Si no se define *policy*, utiliza la política :" +"class:`compat32 `, la cual mantiene compatibilidad " +"con la versión de Python 3.2 del paquete email. Para más información " +"consulta la documentación de :mod:`~email.policy`." #: ../Doc/library/email.compat32-message.rst:64 msgid "The *policy* keyword argument was added." -msgstr "" +msgstr "El argumento de palabra clave *policy* fue añadido." #: ../Doc/library/email.compat32-message.rst:69 msgid "" @@ -114,6 +161,17 @@ msgid "" "control some of the formatting produced by the method, since the specified " "*policy* will be passed to the ``Generator``." msgstr "" +"Retorna el mensaje completo aplanado como una cadena. Cuando el parámetro " +"opcional *unixfrom* es verdadero, el encabezado de envoltura se incluye en " +"la cadena retornada. *unixfrom* es por defecto ``False``. Por razones de " +"compatibilidad con versiones anteriores, *maxheaderlen* es ``0`` por " +"defecto, por lo que si quieres un valor diferente debes debes " +"sobreescribirlo explícitamente (el valor especificado por *max_line_length* " +"en la política será ignorado por este método). El argumento *policy* puede " +"ser usado para sobrescribir la política por defecto obtenida de la instancia " +"del mensaje. Esto puede ser usado para controlar algo del formato producido " +"por el método, ya que la *policy* especificada puede ser pasada al " +"``Generator``." #: ../Doc/library/email.compat32-message.rst:79 #: ../Doc/library/email.compat32-message.rst:121 @@ -122,6 +180,9 @@ msgid "" "defaults need to be filled in to complete the transformation to a string " "(for example, MIME boundaries may be generated or modified)." msgstr "" +"Aplanar el mensaje puede desencadenar cambios en :class:`Message` si por " +"defecto necesita ser rellenado para completar la transformación a una cadena " +"(por ejemplo, límites MIME pueden ser generados o modificados)." #: ../Doc/library/email.compat32-message.rst:83 msgid "" @@ -132,6 +193,12 @@ msgid "" "Generator` instance and use its :meth:`~email.generator.Generator.flatten` " "method directly. For example::" msgstr "" +"Ten en cuenta que este método es proporcionado como conveniencia y puede no " +"siempre formatear el mensaje de la forma que quieres. Por ejemplo, de forma " +"predeterminada no realiza la mutilación de líneas que comienzan con ``From`` " +"que es requerida por el formato unix mbox. Para mayor flexibilidad, " +"instancia un :class:`~email.generator.Generator` y utiliza su método :meth:" +"`~email.generator.Generator.flatten` directamente. Por ejemplo::" #: ../Doc/library/email.compat32-message.rst:97 msgid "" @@ -140,16 +207,22 @@ msgid "" "character\" code points. (See also :meth:`.as_bytes` and :class:`~email." "generator.BytesGenerator`.)" msgstr "" +"Si el objeto de mensaje contiene datos binarios que no están codificados de " +"acuerdo a los estándares RFC, los datos no compatibles serán reemplazados " +"por puntos de código Unicode de \"carácter desconocido\". (Consulta también :" +"meth:`.as_bytes` y :class:`~email.generator.BytesGenerator`.)" #: ../Doc/library/email.compat32-message.rst:102 msgid "the *policy* keyword argument was added." -msgstr "" +msgstr "el argumento de palabra clave *policy* fue añadido." #: ../Doc/library/email.compat32-message.rst:107 msgid "" "Equivalent to :meth:`.as_string()`. Allows ``str(msg)`` to produce a string " "containing the formatted message." msgstr "" +"Equivalente a :meth:`.as_string()`. Permite a ``str(msg)`` producir una " +"cadena conteniendo el mensaje formateado." #: ../Doc/library/email.compat32-message.rst:113 msgid "" @@ -160,6 +233,13 @@ msgid "" "used to control some of the formatting produced by the method, since the " "specified *policy* will be passed to the ``BytesGenerator``." msgstr "" +"Retorna el mensaje completo aplanado como un objeto de bytes. Cuando el " +"argumento opcional *unixfrom* es verdadero, el encabezado de envoltura se " +"incluye en la cadena retornada. *unixfrom* es por defecto ``False``. El " +"argumento *policy* puede ser usado para sobrescribir la política por defecto " +"obtenida desde la instancia del mensaje. Esto puede ser usado para controlar " +"algo del formato producido por el método, ya que el *policy* especificado " +"será pasado al ``BytesGenerator``." #: ../Doc/library/email.compat32-message.rst:125 msgid "" @@ -170,12 +250,20 @@ msgid "" "BytesGenerator` instance and use its :meth:`~email.generator.BytesGenerator." "flatten` method directly. For example::" msgstr "" +"Nota que este método es proporcionado como conveniencia y puede no siempre " +"formatear el mensaje de la forma que quieres. Por ejemplo, por defecto no " +"realiza la mutilación de línea que comienzan con ``From`` que es requerida " +"por el formato unix mbox. Para mayor flexibilidad, instancia un :class:" +"`~email.generator.BytesGenerator` y utiliza su método :meth:`~email." +"generator.BytesGenerator.flatten` directamente. Por ejemplo::" #: ../Doc/library/email.compat32-message.rst:145 msgid "" "Equivalent to :meth:`.as_bytes()`. Allows ``bytes(msg)`` to produce a bytes " "object containing the formatted message." msgstr "" +"Equivalente a :meth:`.as_bytes()`. Permite a ``bytes(msg)`` producir un " +"objeto de bytes conteniendo el mensaje formateado." #: ../Doc/library/email.compat32-message.rst:153 msgid "" @@ -187,17 +275,29 @@ msgid "" "'multipart'\" will return the ``True``. For example, ``is_multipart`` will " "return ``True`` when the :class:`Message` is of type ``message/rfc822``.)" msgstr "" +"Retorna ``True`` si la carga del mensaje es una lista de objetos heredados " +"de :class:`Message`, si no retorna ``False``. Cuando :meth:`is_multipart` " +"retorna ``False``, la carga debe ser un objeto de cadena (el cual puede ser " +"una carga CTE codificada en binario). (Ten en cuenta que :meth:" +"`is_multipart` retornando ``True`` no significa necesariamente que \"msg." +"get_content_maintype() == 'multipart'\" retornará ``True``. Por ejemplo, " +"``is_multipart`` retornará ``True`` cuando el :class:`Message` es de tipo " +"``message/rfc822``.)" #: ../Doc/library/email.compat32-message.rst:165 msgid "" "Set the message's envelope header to *unixfrom*, which should be a string." msgstr "" +"Establece el mensaje del encabezado de envoltura a *unixfrom*, el cual debe " +"ser una cadena." #: ../Doc/library/email.compat32-message.rst:170 msgid "" "Return the message's envelope header. Defaults to ``None`` if the envelope " "header was never set." msgstr "" +"Retorna el mensaje del encabezado de envoltura. Por defecto a ``None`` si el " +"encabezado de envoltura nunca fue definido." #: ../Doc/library/email.compat32-message.rst:176 msgid "" @@ -207,6 +307,11 @@ msgid "" "set the payload to a scalar object (e.g. a string), use :meth:`set_payload` " "instead." msgstr "" +"Añade el *payload* dado a la carga actual, la cual debe ser ``None`` o una " +"lista de objetos :class:`Message` antes de la invocación. Después de la " +"invocación, la carga siempre será una lista de objetos :class:`Message`. Si " +"quieres definir la carga a un objeto escalar (ej. una cadena), usa :meth:" +"`set_payload` en su lugar." #: ../Doc/library/email.compat32-message.rst:182 msgid "" @@ -214,6 +319,9 @@ msgid "" "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content` and the related ``make`` and ``add`` methods." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por :meth:`~email.message." +"EmailMessage.set_content` y los métodos relacionados ``make`` y ``add``." #: ../Doc/library/email.compat32-message.rst:190 msgid "" @@ -222,6 +330,10 @@ msgid "" "is ``False``. If the payload is a list and you mutate the list object, you " "modify the message's payload in place." msgstr "" +"Retorna la carga (*payload*) actual, la cual será una lista de objetos :" +"class:`Message` cuando :meth:`is_multipart` es ``True``, o una cadena " +"cuando :meth:`is_multipart` es ``False``. Si la carga es una lista y mutas " +"el objeto de lista, modificarás la carga del mensaje." #: ../Doc/library/email.compat32-message.rst:195 msgid "" @@ -232,6 +344,12 @@ msgid "" "is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, a :" "exc:`TypeError` is raised." msgstr "" +"Con el argumento opcional *i*, :meth:`get_payload` retornará el elemento " +"número *i* de la carga (*payload*), contando desde cero, si :meth:" +"`is_multipart` es ``True``. Un :exc:`IndexError` será generado si *i* es " +"menor que 0 ó mayor o igual que el número de elementos en la carga. Si la " +"carga es una cadena (ej. :meth:`is_multipart` es ``False``) y se define *i*, " +"se genera un :exc:`TypeError`." #: ../Doc/library/email.compat32-message.rst:202 msgid "" @@ -248,6 +366,19 @@ msgid "" "message's defect property (:class:`~email.errors.InvalidBase64PaddingDefect` " "or :class:`~email.errors.InvalidBase64CharactersDefect`, respectively)." msgstr "" +"El argumento opcional *decode* es un indicador que determina si una carga " +"debería ser decodificada o no, de acuerdo al encabezado :mailheader:`Content-" +"Transfer-Encoding`. Cuando es ``True`` y el mensaje no es multiparte, la " +"carga será decodificada si el valor de su encabezado es ``quoted-printable`` " +"o ``base64``. Si se usa alguna otra codificación o falta el encabezado :" +"mailheader:`Content-Transfer-Encoding`, la carga es retornada tal cual (sin " +"decodificar). En todos los casos el valor retornado son datos binarios. Si " +"el mensaje es multiparte y el indicador *decode* es ``True``, entonces se " +"retorna ``None``. Si la carga es base64 y no fue perfectamente formada " +"(falta relleno, tiene caracteres fuera del alfabeto base64), entonces un " +"defecto apropiado será añadido a la propiedad defect del mensaje (:class:" +"`~email.errors.InvalidBase64PaddingDefect` o :class:`~email.errors." +"InvalidBase64CharactersDefect`, respectivamente)." #: ../Doc/library/email.compat32-message.rst:216 msgid "" @@ -259,6 +390,14 @@ msgid "" "``charset`` is specified, or if the ``charset`` given is not recognized by " "the email package, the body is decoded using the default ASCII charset." msgstr "" +"Cuando *decode* es ``False`` (por defecto) el cuerpo es retornado como una " +"cadena sin decodificar el :mailheader:`Content-Transfer-Encoding`. Sin " +"embargo, para un :mailheader:`Content-Transfer-Encoding` de 8bit, se realiza " +"un intento para decodificar los bytes originales usando el ``charset`` " +"especificado por el encabezado :mailheader:`Content-Type`, usando el " +"manejador de error ``replace``. Si ningún ``charset`` es especificado o si " +"el ``charset`` dado no es reconocido por el paquete email, el cuerpo es " +"decodificado usando el conjunto de caracteres ASCII por defecto." #: ../Doc/library/email.compat32-message.rst:225 msgid "" @@ -266,6 +405,9 @@ msgid "" "class its functionality is replaced by :meth:`~email.message.EmailMessage." "get_content` and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por :meth:`~email.message." +"EmailMessage.get_content` y :meth:`~email.message.EmailMessage.iter_parts`." #: ../Doc/library/email.compat32-message.rst:233 msgid "" @@ -273,6 +415,10 @@ msgid "" "responsibility to ensure the payload invariants. Optional *charset* sets " "the message's default character set; see :meth:`set_charset` for details." msgstr "" +"Define la carga completa del objeto mensaje a *payload*. Es responsabilidad " +"del cliente asegurar invariantes de carga. El argumento opcional *charset* " +"define el conjunto de caracteres por defecto del mensaje; consulta :meth:" +"`set_charset` para más detalles." #: ../Doc/library/email.compat32-message.rst:237 msgid "" @@ -280,6 +426,9 @@ msgid "" "class its functionality is replaced by :meth:`~email.message.EmailMessage." "set_content`." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por :meth:`~email.message." +"EmailMessage.set_content`." #: ../Doc/library/email.compat32-message.rst:244 msgid "" @@ -291,6 +440,13 @@ msgid "" "`Content-Type` header (the message will not be otherwise modified). " "Anything else will generate a :exc:`TypeError`." msgstr "" +"Define el junto de caracteres de la carga a *charset*, el cual puede ser " +"tanto una instancia :class:`~email.charset.Charset` (ver :mod:`email." +"charset`), una cadena denominando un conjunto de caracteres, o ``None``. Si " +"es una cadena, será convertida a una instancia :class:`~email.charset." +"Charset`. Si *charset* es ``None``, el parámetro ``charset`` será eliminado " +"del encabezado :mailheader:`Content-Type` (el mensaje no será modificado de " +"otra manera). Cualquier otro valor generará un :exc:`TypeError`." #: ../Doc/library/email.compat32-message.rst:252 msgid "" @@ -308,6 +464,19 @@ msgid "" "correctly encoded using that :mailheader:`Content-Transfer-Encoding` and is " "not modified." msgstr "" +"Si no hay un encabezado existente :mailheader:`MIME-Version`, será añadido " +"uno. Si no hay un encabezado existente :mailheader:`Content-Type`, será " +"añadido uno con valor :mimetype:`text/plain`. Tanto como si el encabezado :" +"mailheader:`Content-Type` existe actualmente como si no, su parámetro " +"``charset`` será establecido a *charset.output_charset*. Si *charset." +"input_charset* y *charset.output_charset* difieren, la carga será " +"recodificada al *output_charset*. Si no hay un encabezado existente :" +"mailheader:`Content-Transfer-Encoding`, entonces la carga será codificada " +"por transferencia, si es necesario, usando el :class:`~email.charset." +"Charset` especificado y un encabezado con el valor apropiado será añadido. " +"Si ya existe un encabezado :mailheader:`Content-Transfer-Encoding`, la carga " +"se asume que ya está correctamente codificada usando ese :mailheader:" +"`Content-Transfer-Encoding` y no es modificada." #: ../Doc/library/email.compat32-message.rst:266 msgid "" @@ -315,18 +484,25 @@ msgid "" "class its functionality is replaced by the *charset* parameter of the :meth:" "`email.emailmessage.EmailMessage.set_content` method." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por el parámetro *charset* del " +"método :meth:`email.emailmessage.EmailMessage.set_content`." #: ../Doc/library/email.compat32-message.rst:274 msgid "" "Return the :class:`~email.charset.Charset` instance associated with the " "message's payload." msgstr "" +"Retorna la instancia :class:`~email.charset.Charset` asociada con la carga " +"del mensaje." #: ../Doc/library/email.compat32-message.rst:277 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class it always returns ``None``." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` siempre retorna ``None``." #: ../Doc/library/email.compat32-message.rst:282 msgid "" @@ -340,18 +516,33 @@ msgid "" "the original message, or were added to the message later. Any header " "deleted and then re-added are always appended to the end of the header list." msgstr "" +"Los siguientes métodos implementan una interfaz parecida a un mapeo para " +"acceder a los encabezados :rfc:`2822` del mensaje. Ten en cuenta que hay " +"algunas diferencias semánticas entre esos métodos y una interfaz de mapeo " +"normal (ej. diccionario). Por ejemplo, en un diccionario no hay claves " +"duplicadas, pero aquí pueden haber encabezados de mensaje duplicados. " +"También, en diccionarios no hay un orden garantizado de las claves " +"retornadas por :meth:`keys`, pero en un objeto :class:`Message`, los " +"encabezados siempre son retornados en el orden que aparecieron en el mensaje " +"original, o en el que fueron añadidos al mensaje más tarde. Cualquier " +"encabezado eliminado y vuelto a adicionar siempre es añadido al final de la " +"lista de encabezados." #: ../Doc/library/email.compat32-message.rst:292 msgid "" "These semantic differences are intentional and are biased toward maximal " "convenience." msgstr "" +"Esas diferencias semánticas son intencionales y están sesgadas hacia la " +"máxima comodidad." #: ../Doc/library/email.compat32-message.rst:295 msgid "" "Note that in all cases, any envelope header present in the message is not " "included in the mapping interface." msgstr "" +"Ten en cuenta que en todos los casos, cualquier encabezado de envoltura " +"presente en el mensaje no está incluido en la interfaz de mapeo." #: ../Doc/library/email.compat32-message.rst:298 msgid "" @@ -360,10 +551,14 @@ msgid "" "interface, be represented as :class:`~email.header.Header` objects with a " "charset of `unknown-8bit`." msgstr "" +"En un modelo generado desde bytes, cualesquiera valores de encabezado que " +"(en contravención de los RFCs) contienen bytes ASCII serán representados, " +"cuando sean obtenidos mediante esta interfaz, como objetos :class:`~email." +"header.Header` con un conjunto de caracteres `unknown-8bit`." #: ../Doc/library/email.compat32-message.rst:306 msgid "Return the total number of headers, including duplicates." -msgstr "" +msgstr "Retorna el número total de encabezados, incluyendo duplicados." #: ../Doc/library/email.compat32-message.rst:311 msgid "" @@ -371,6 +566,10 @@ msgid "" "done case-insensitively and *name* should not include the trailing colon. " "Used for the ``in`` operator, e.g.::" msgstr "" +"Retorna ``True`` si el objeto mensaje tiene un campo llamado *name*. La " +"concordancia se realiza sin distinguir mayúsculas de minúsculas y *name* no " +"debería incluir el caracter de doble punto final. Usado para el operador " +"``in``, ej::" #: ../Doc/library/email.compat32-message.rst:321 msgid "" @@ -378,6 +577,9 @@ msgid "" "colon field separator. If the header is missing, ``None`` is returned; a :" "exc:`KeyError` is never raised." msgstr "" +"Retorna el valor del campo del encabezado nombrado. *name* no debe incluir " +"el separador de campo de doble punto. Si falta un encabezado, se retorna " +"``None``; nunca se genera un error :exc:`KeyError`." #: ../Doc/library/email.compat32-message.rst:325 msgid "" @@ -386,12 +588,18 @@ msgid "" "Use the :meth:`get_all` method to get the values of all the extant named " "headers." msgstr "" +"Ten en cuenta que si el campo nombrado aparece más de una vez en los " +"encabezados del mensaje, no se define cuales serán exactamente aquellos " +"valores de campos retornados. Usa el método :meth:`get_all` para obtener los " +"valores de todos los encabezados nombrados existentes." #: ../Doc/library/email.compat32-message.rst:333 msgid "" "Add a header to the message with field name *name* and value *val*. The " "field is appended to the end of the message's existing fields." msgstr "" +"Añade un encabezado al mensaje con el nombre de campo *name* y el valor " +"*val*. El campo es añadido al final de los campos existentes del mensaje." #: ../Doc/library/email.compat32-message.rst:336 msgid "" @@ -399,6 +607,10 @@ msgid "" "same name. If you want to ensure that the new header is the only one " "present in the message with field name *name*, delete the field first, e.g.::" msgstr "" +"Ten en cuenta que esto no sobreescribe ni elimina ningún encabezado " +"existente con el mismo nombre. Si quieres asegurar que el nuevo encabezado " +"es el único presente en el mensaje con el nombre de campo *name*, elimina el " +"campo primero, ej::" #: ../Doc/library/email.compat32-message.rst:346 msgid "" @@ -406,20 +618,26 @@ msgid "" "headers. No exception is raised if the named field isn't present in the " "headers." msgstr "" +"Elimina todas las ocurrencias de un campo con el nombre *name* de los " +"encabezados del mensaje. No se genera ninguna excepción si el encabezado " +"nombrado no está presente en los encabezados." #: ../Doc/library/email.compat32-message.rst:353 msgid "Return a list of all the message's header field names." msgstr "" +"Retorna una lista de todos los nombres de campos de encabezados del mensaje." #: ../Doc/library/email.compat32-message.rst:358 msgid "Return a list of all the message's field values." -msgstr "" +msgstr "Retorna una lista de todos los valores de campos del mensaje." #: ../Doc/library/email.compat32-message.rst:363 msgid "" "Return a list of 2-tuples containing all the message's field headers and " "values." msgstr "" +"Retorna una lista de tuplas de dos elementos conteniendo todos los campos y " +"valores de encabezados del mensaje." #: ../Doc/library/email.compat32-message.rst:369 msgid "" @@ -427,10 +645,13 @@ msgid "" "`__getitem__` except that optional *failobj* is returned if the named header " "is missing (defaults to ``None``)." msgstr "" +"Retorna el valor del campo de encabezado nombrado. Esto es idéntico a :meth:" +"`__getitem__` excepto que el argumento *failobj* es retornado si falta el " +"encabezado nombrado (por defecto a ``None``)." #: ../Doc/library/email.compat32-message.rst:373 msgid "Here are some additional useful methods:" -msgstr "" +msgstr "Aquí hay algunos métodos útiles adicionales:" #: ../Doc/library/email.compat32-message.rst:378 msgid "" @@ -438,6 +659,9 @@ msgid "" "such named headers in the message, *failobj* is returned (defaults to " "``None``)." msgstr "" +"Retorna una lista de todos los valores para el campo denominado *name*. Si " +"no hay tales encabezados nombrados en el mensaje, retorna *failobj* (por " +"defecto ``None``)." #: ../Doc/library/email.compat32-message.rst:385 msgid "" @@ -446,6 +670,10 @@ msgid "" "arguments. *_name* is the header field to add and *_value* is the *primary* " "value for the header." msgstr "" +"Configuración de encabezado extendida. Este método es similar a :meth:" +"`__setitem__` excepto que pueden ser provistos parámetros adicionales de " +"encabezado como argumentos de palabra clave. *_name* es el campo de " +"encabezado a añadir y *_value* es el valor *primario* para el encabezado." #: ../Doc/library/email.compat32-message.rst:390 msgid "" @@ -463,22 +691,36 @@ msgid "" "`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of " "``None``." msgstr "" +"Para cada elemento en el diccionario de argumentos de palabra clave " +"*_params*, la clave se toma como el nombre del parámetro con guiones bajos " +"convertidos a guiones medios (ya que los guiones medios son ilegales como " +"identificadores en Python). Normalmente, el parámetro será añadido como " +"``key=\"value\"`` a no ser que el valor sea ``None``, en cuyo caso sólo la " +"clave será añadida. Si el valor contiene caracteres no ASCII, puede ser " +"especificado como una tupla de tres elementos en el formato ``(CHARSET, " +"LANGUAGE, VALUE)``, donde ``CHARSET`` es una cadena que nombra el conjunto " +"de caracteres a ser usado al codificar el valor, ``LANGUAGE`` puede " +"normalmente ser definido a ``None`` o una cadena vacía (ver :rfc:`2231` para " +"otras posibilidades) y ``VALUE`` es la cadena del valor conteniendo puntos " +"de caracteres no ASCII. Si no se pasa una tupla de tres elementos y el valor " +"contiene caracteres no ASCII, se codifica automáticamente en formato :rfc:" +"`2231` usando ``CHARSET`` como ``utf-8`` y ``LANGUAGE`` como ``None``." #: ../Doc/library/email.compat32-message.rst:404 msgid "Here's an example::" -msgstr "" +msgstr "Aquí hay un ejemplo::" #: ../Doc/library/email.compat32-message.rst:408 msgid "This will add a header that looks like ::" -msgstr "" +msgstr "Esto añadirá un encabezado que se verá como ::" #: ../Doc/library/email.compat32-message.rst:412 msgid "An example with non-ASCII characters::" -msgstr "" +msgstr "Un ejemplo con caracteres no ASCII::" #: ../Doc/library/email.compat32-message.rst:417 msgid "Which produces ::" -msgstr "" +msgstr "Lo que produce ::" #: ../Doc/library/email.compat32-message.rst:424 msgid "" @@ -486,6 +728,10 @@ msgid "" "matches *_name*, retaining header order and field name case. If no matching " "header was found, a :exc:`KeyError` is raised." msgstr "" +"Reemplaza un encabezado. Reemplaza el primer encabezado encontrado en el " +"mensaje que concuerda con *_name*, conservando el orden del encabezado y el " +"nombre del campo. Si no se encuentra ningún encabezado que concuerde, se " +"genera un error :exc:`KeyError`." #: ../Doc/library/email.compat32-message.rst:431 msgid "" @@ -496,6 +742,12 @@ msgid "" "messages always have a default type, :meth:`get_content_type` will always " "return a value." msgstr "" +"Retorna el tipo de contenido del mensaje. La cadena retornada se fuerza a " +"letras minúsculas de la forma :mimetype:`maintype/subtype`. Si no hay ningún " +"encabezado :mailheader:`Content-Type` en el mensaje será retornado el tipo " +"por defecto como es dado por :meth:`get_default_type`. Dado que según :rfc:" +"`2045`, los mensajes tienen siempre un tipo predeterminado, :meth:" +"`get_content_type` siempre retornará un valor." #: ../Doc/library/email.compat32-message.rst:438 msgid "" @@ -505,18 +757,27 @@ msgid "" "Type` header has an invalid type specification, :rfc:`2045` mandates that " "the default type be :mimetype:`text/plain`." msgstr "" +":rfc:`2045` define el tipo predeterminado del mensaje a :mimetype:`text/" +"plain` a no ser que aparezca dentro de un contenedor :mimetype:`multipart/" +"digest`, en cuyo caso sería :mimetype:`message/rfc822`. Si el encabezado :" +"mailheader:`Content-Type` tiene una especificación de tipo inválido, :rfc:" +"`2045` ordena que el tipo por defecto sea :mimetype:`text/plain`." #: ../Doc/library/email.compat32-message.rst:447 msgid "" "Return the message's main content type. This is the :mimetype:`maintype` " "part of the string returned by :meth:`get_content_type`." msgstr "" +"Retorna el tipo de contenido principal del mensaje. Esta es la parte :" +"mimetype:`maintype` de la cadena retornada por :meth:`get_content_type`." #: ../Doc/library/email.compat32-message.rst:453 msgid "" "Return the message's sub-content type. This is the :mimetype:`subtype` part " "of the string returned by :meth:`get_content_type`." msgstr "" +"Retorna el tipo del subcontenido del mensaje. Esta es la parte :mimetype:" +"`subtype` de la cadena retornada por :meth:`get_content_type`." #: ../Doc/library/email.compat32-message.rst:459 msgid "" @@ -525,6 +786,11 @@ msgid "" "mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" +"Retorna el tipo del contenido por defecto. La mayoría de mensajes tienen un " +"tipo de contenido por defecto de :mimetype:`text/plain`, excepto para " +"mensajes que son subpartes de contenedores :mimetype:`multipart/digest`. " +"Tales subpartes tienen como tipo de contenido predeterminado :mimetype:" +"`message/rfc822`." #: ../Doc/library/email.compat32-message.rst:467 msgid "" @@ -532,6 +798,10 @@ msgid "" "plain` or :mimetype:`message/rfc822`, although this is not enforced. The " "default content type is not stored in the :mailheader:`Content-Type` header." msgstr "" +"Establece el tipo de contenido por defecto. *ctype* debería ser :mimetype:" +"`text/plain` o :mimetype:`message/rfc822`, aunque esto no es obligatorio. El " +"tipo de contenido predeterminado no se almacena en el encabezado :mailheader:" +"`Content-Type`." #: ../Doc/library/email.compat32-message.rst:475 msgid "" @@ -542,6 +812,13 @@ msgid "" "the value is the empty string, otherwise the value is as described in :meth:" "`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." msgstr "" +"Retorna los parámetros del :mailheader:`Content-Type` del mensaje como una " +"lista. Los elementos de la lista retornada son tuplas de dos elementos de " +"pares clave/valor, tal y como son partidas por el signo ``'='``. El lado " +"izquierdo del ``'='`` es la clave, mientras el lado derecho es el valor. Si " +"no hay signo ``'='`` en el parámetro, el valor es la cadena vacía, en caso " +"contrario el valor es como se describe en :meth:`get_param` y no está citado " +"si el parámetro opcional *unquote* es ``True`` (por defecto)." #: ../Doc/library/email.compat32-message.rst:483 msgid "" @@ -549,6 +826,9 @@ msgid "" "`Content-Type` header. Optional *header* is the header to search instead " "of :mailheader:`Content-Type`." msgstr "" +"El parámetro opcional *failobj* es el objeto a retornar si no hay " +"encabezado :mailheader:`Content-Type`. El parámetro opcional *header* es el " +"encabezado a buscar en lugar de :mailheader:`Content-Type`." #: ../Doc/library/email.compat32-message.rst:487 #: ../Doc/library/email.compat32-message.rst:525 @@ -557,6 +837,10 @@ msgid "" "class its functionality is replaced by the *params* property of the " "individual header objects returned by the header access methods." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por la propiedad *params* de " +"los objetos individuales de encabezado retornados por los métodos de acceso " +"del encabezado." #: ../Doc/library/email.compat32-message.rst:495 msgid "" @@ -565,12 +849,18 @@ msgid "" "header or if there is no such parameter, then *failobj* is returned " "(defaults to ``None``)." msgstr "" +"Retorna el valor del parámetro *param* del encabezado :mailheader:`Content-" +"Type` como una cadena. Si el mensaje no tiene encabezado :mailheader:" +"`Content-Type` o si no existe tal parámetro, entonces se retorna *failobj* " +"(por defecto es ``None``)." #: ../Doc/library/email.compat32-message.rst:500 msgid "" "Optional *header* if given, specifies the message header to use instead of :" "mailheader:`Content-Type`." msgstr "" +"El parámetro opcional *header*, si es definido, especifica el encabezado del " +"mensaje a usar en lugar de :mailheader:`Content-Type`." #: ../Doc/library/email.compat32-message.rst:503 msgid "" @@ -581,6 +871,14 @@ msgid "" "``None``, in which case you should consider ``VALUE`` to be encoded in the " "``us-ascii`` charset. You can usually ignore ``LANGUAGE``." msgstr "" +"Las claves de parámetros siempre son comparadas distinguiendo entre " +"mayúsculas y minúsculas. El valor de retorno puede ser una cadena, una tupla " +"de 3 elementos si el parámetro fue codificado según :rfc:`2231`. Cuando es " +"una tupla de 3 elementos, los elementos del valor tienen la forma " +"``(CHARSET, LANGUAGE, VALUE)``. Ten en cuenta que ``CHARSET`` y ``LANGUAGE`` " +"pueden ser ``None``, en cuyo caso debes considerar ``VALUE`` como codificado " +"en el conjunto de caracteres ``us-ascii``. Generalmente puedes ignorar " +"``LANGUAGE``." #: ../Doc/library/email.compat32-message.rst:511 msgid "" @@ -590,6 +888,12 @@ msgid "" "`get_param`. This will return a suitably decoded Unicode string when the " "value is a tuple, or the original string unquoted if it isn't. For example::" msgstr "" +"Si a tu aplicación no le importa si el parámetro fue codificado según :rfc:" +"`2231`, puedes contraer el valor del parámetro invocando :func:`email.utils." +"collapse_rfc2231_value`, pasando el valor de retorno desde :meth:" +"`get_param`. Esto retornará una cadena Unicode convenientemente decodificada " +"cuando el valor es una tupla o la cadena original sin entrecomillar si no lo " +"es. Por ejemplo::" #: ../Doc/library/email.compat32-message.rst:521 msgid "" @@ -597,6 +901,9 @@ msgid "" "``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " "to ``False``." msgstr "" +"En cualquier caso, el valor del parámetro (tanto la cadena retornada o el " +"elemento ``VALUE`` en la tupla de 3 elementos) siempre está sin " +"entrecomillar, a no ser que *unquote* está establecido a ``False``." #: ../Doc/library/email.compat32-message.rst:534 msgid "" @@ -606,6 +913,11 @@ msgid "" "message, it will be set to :mimetype:`text/plain` and the new parameter " "value will be appended as per :rfc:`2045`." msgstr "" +"Establece un parámetro en el encabezado :mailheader:`Content-Type`. Si el " +"parámetro ya existe en el encabezado, su valor será remplazado con *value*. " +"Si el encabezado :mailheader:`Content-Type` no ha sido definido todavía para " +"este mensaje, será establecido a :mimetype:`text/plain` y el nuevo valor del " +"parámetro será añadido según :rfc:`2045`." #: ../Doc/library/email.compat32-message.rst:540 msgid "" @@ -613,6 +925,10 @@ msgid "" "Type`, and all parameters will be quoted as necessary unless optional " "*requote* is ``False`` (the default is ``True``)." msgstr "" +"El parámetro opcional *header* especifica una alternativa a :mailheader:" +"`Content-Type` y todos los parámetros serán entrecomillados si es necesario " +"a no ser que el parámetro opcional *requote* sea ``False`` (por defecto es " +"``True``)." #: ../Doc/library/email.compat32-message.rst:544 msgid "" @@ -621,6 +937,10 @@ msgid "" "defaulting to the empty string. Both *charset* and *language* should be " "strings." msgstr "" +"Si se especifica el parámetro opcional *charset*, el parámetro será " +"codificado de acuerdo a :rfc:`2231`. El parámetro opcional *language* " +"especifica el lenguaje RFC 2231, por defecto una cadena vacía. Tanto " +"*charset* como *language* deberían ser cadenas." #: ../Doc/library/email.compat32-message.rst:549 msgid "" @@ -628,10 +948,13 @@ msgid "" "the list of headers. If *replace* is ``True``, the header will be updated " "in place." msgstr "" +"Si *replace* es ``False`` (por defecto) el encabezado será movido al final " +"de la lista de encabezados. Si *replace* es ``True``, el encabezado será " +"actualizado." #: ../Doc/library/email.compat32-message.rst:553 msgid "``replace`` keyword was added." -msgstr "" +msgstr "el parámetro de palabra clave ``replace`` fue añadido." #: ../Doc/library/email.compat32-message.rst:558 msgid "" @@ -641,6 +964,11 @@ msgid "" "(the default is ``True``). Optional *header* specifies an alternative to :" "mailheader:`Content-Type`." msgstr "" +"Elimina el parámetro dado completamente del encabezado :mailheader:`Content-" +"Type`. El encabezado será reescrito en sí mismo sin el parámetro o su valor. " +"Todos los valores serán entrecomillados si es necesario a no ser que " +"*requote* sea ``False`` (por defecto es ``True``). El parámetro opcional " +"*header* especifica una alternativa a :mailheader:`Content-Type`." #: ../Doc/library/email.compat32-message.rst:567 msgid "" @@ -648,6 +976,9 @@ msgid "" "*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " "a :exc:`ValueError` is raised." msgstr "" +"Establece el tipo y subtipo principal para el encabezado :mailheader:" +"`Content-Type`. *type* debe ser una cadena de la forma :mimetype:`maintype/" +"subtype`, si no será generado un :exc:`ValueError`." #: ../Doc/library/email.compat32-message.rst:571 msgid "" @@ -656,6 +987,10 @@ msgid "" "header's quoting as is, otherwise the parameters will be quoted (the " "default)." msgstr "" +"Este método remplaza el encabezado :mailheader:`Content-Type`, manteniendo " +"todos los parámetros en su lugar. Si *requote* es ``False``, este dejará el " +"encabezado existente tal como está, en caso contrario los parámetros serán " +"entrecomillados (por defecto)." #: ../Doc/library/email.compat32-message.rst:576 msgid "" @@ -663,12 +998,18 @@ msgid "" "mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " "is also added." msgstr "" +"Un encabezado alternativo puede ser especificado en el argumento *header*. " +"Cuando el encabezado :mailheader:`Content-Type` es definido, un encabezado :" +"mailheader:`MIME-Version` también es añadido." #: ../Doc/library/email.compat32-message.rst:580 msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " "class its functionality is replaced by the ``make_`` and ``add_`` methods." msgstr "" +"Este es un método heredado. En la clase :class:`~email.emailmessage." +"EmailMessage` su funcionalidad es remplazada por los métodos ``make_`` y " +"``add_``." #: ../Doc/library/email.compat32-message.rst:587 msgid "" @@ -679,6 +1020,12 @@ msgid "" "the header is missing, then *failobj* is returned. The returned string will " "always be unquoted as per :func:`email.utils.unquote`." msgstr "" +"Retorna el valor del parámetro ``filename`` del encabezado :mailheader:" +"`Content-Disposition` del mensaje. Si el encabezado no tiene un parámetro " +"``filename``, este método recurre a buscar el parámetro ``name`` en el " +"encabezado :mailheader:`Content-Type`. Si tampoco se encuentra o falta el " +"encabezado, entonces retorna *failobj*. La cadena retornada siempre será sin " +"entrecomillar según :func:`email.utils.unquote`." #: ../Doc/library/email.compat32-message.rst:598 msgid "" @@ -687,6 +1034,10 @@ msgid "" "or has no ``boundary`` parameter. The returned string will always be " "unquoted as per :func:`email.utils.unquote`." msgstr "" +"Retorna el valor del parámetro ``boundary`` del encabezado :mailheader:" +"`Content-Type` del mensaje o *failobj* tanto si falta el encabezado como si " +"no tiene parámetro ``boundary``. La cadena retornada siempre será sin " +"entrecomillar según :func:`email.utils.unquote`." #: ../Doc/library/email.compat32-message.rst:606 msgid "" @@ -695,6 +1046,10 @@ msgid "" "necessary. A :exc:`~email.errors.HeaderParseError` is raised if the message " "object has no :mailheader:`Content-Type` header." msgstr "" +"Establece el parámetro ``boundary`` del encabezado :mailheader:`Content-" +"Type` a *boundary*. :meth:`set_boundary` siempre entrecomillará *boundary* " +"si es necesario. Se genera :exc:`~email.errors.HeaderParseError` si el " +"objeto de mensaje no tiene encabezado :mailheader:`Content-Type`." #: ../Doc/library/email.compat32-message.rst:611 msgid "" @@ -705,6 +1060,13 @@ msgid "" "does *not* preserve any continuation lines which may have been present in " "the original :mailheader:`Content-Type` header." msgstr "" +"Ten en cuenta que usar este método es sutilmente diferente a borrar el " +"antiguo encabezado :mailheader:`Content-Type` y añadir uno nuevo con el " +"nuevo límite mediante :meth:`add_header` porque :meth:`set_boundary` " +"preserva el orden del encabezado :mailheader:`Content-Type` en la lista de " +"encabezados. Sin embargo, no conserva ninguna línea de continuación que " +"pueden haber estado presentes en el encabezado original :mailheader:`Content-" +"Type`." #: ../Doc/library/email.compat32-message.rst:621 msgid "" @@ -712,6 +1074,10 @@ msgid "" "coerced to lower case. If there is no :mailheader:`Content-Type` header, or " "if that header has no ``charset`` parameter, *failobj* is returned." msgstr "" +"Retorna el parámetro ``charset`` del encabezado :mailheader:`Content-Type`, " +"forzado a letras minúsculas. Si no hay un encabezado :mailheader:`Content-" +"Type` o si ese encabezado no tiene parámetro ``charset``, se retorna " +"*failobj*." #: ../Doc/library/email.compat32-message.rst:625 msgid "" @@ -719,6 +1085,9 @@ msgid "" "class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" +"Ten en cuenta que este método difiere de :meth:`get_charset`, el cual " +"retorna la instancia :class:`~email.charset.Charset` para la codificación " +"por defecto del cuerpo del mensaje." #: ../Doc/library/email.compat32-message.rst:631 msgid "" @@ -726,6 +1095,10 @@ msgid "" "message is a :mimetype:`multipart`, then the list will contain one element " "for each subpart in the payload, otherwise, it will be a list of length 1." msgstr "" +"Retorna una lista conteniendo los nombres de los conjuntos de caracteres en " +"el mensaje. Si el mensaje es :mimetype:`multipart`, entonces la lista " +"contendrá un elemento para cada subparte en la carga (*payload*), en caso " +"contrario será una lista de un elemento." #: ../Doc/library/email.compat32-message.rst:635 msgid "" @@ -735,6 +1108,12 @@ msgid "" "no ``charset`` parameter, or is not of the :mimetype:`text` main MIME type, " "then that item in the returned list will be *failobj*." msgstr "" +"Cada elemento en la lista será una cadena la cual es el valor del parámetro " +"``charset`` en el encabezado :mailheader:`Content-Type` para la subparte " +"representada. Sin embargo, si la subparte no tiene encabezado :mailheader:" +"`Content-Type`, no tiene parámetro ``charset`` o no es del tipo MIME :" +"mimetype:`text` principal, entonces ese elemento en la lista retornada será " +"*failobj*." #: ../Doc/library/email.compat32-message.rst:645 msgid "" @@ -743,6 +1122,10 @@ msgid "" "possible values for this method are *inline*, *attachment* or ``None`` if " "the message follows :rfc:`2183`." msgstr "" +"Retorna el valor en minúsculas (sin parámetros) del encabezado del mensaje :" +"mailheader:`Content-Disposition` si tiene uno o ``None``. Los valores " +"posibles para este método son *inline*, *attachment* o ``None`` si el " +"mensaje sigue el :rfc:`2183`." #: ../Doc/library/email.compat32-message.rst:654 msgid "" @@ -751,12 +1134,19 @@ msgid "" "first traversal order. You will typically use :meth:`walk` as the iterator " "in a ``for`` loop; each iteration returns the next subpart." msgstr "" +"El método :meth:`walk` es un generador de todo propósito el cual puede ser " +"usado para iterar sobre todas las partes y subpartes de árbol de objeto de " +"mensaje, en orden de recorrido de profundidad primero. Siempre usarás " +"típicamente :meth:`walk` como iterador en un bucle ``for``; cada iteración " +"retorna la siguiente subparte." #: ../Doc/library/email.compat32-message.rst:659 msgid "" "Here's an example that prints the MIME type of every part of a multipart " "message structure:" msgstr "" +"Aquí hay un ejemplo que imprime el tipo MIME de cada parte de una estructura " +"de mensaje multiparte:" #: ../Doc/library/email.compat32-message.rst:685 msgid "" @@ -765,6 +1155,10 @@ msgid "" "may return ``False``. We can see this in our example by making use of the " "``_structure`` debug helper function:" msgstr "" +"``walk`` itera sobre las subpartes de cualquier parte donde :meth:" +"`is_multipart` retorna ``True``, aunque ``msg.get_content_maintype() == " +"'multipart'`` puede retornar ``False``. Vemos esto en nuestro ejemplo " +"haciendo uso de la función de ayuda de depuración ``_structure``:" #: ../Doc/library/email.compat32-message.rst:712 msgid "" @@ -772,6 +1166,9 @@ msgid "" "subparts. ``is_multipart()`` returns ``True`` and ``walk`` descends into the " "subparts." msgstr "" +"Aquí las partes de ``message``no son ``multiparts``, pero contienen " +"subpartes. ``is_multipart()`` retorna ``True`` y ``walk`` desciende a las " +"subpartes." #: ../Doc/library/email.compat32-message.rst:717 msgid "" @@ -779,6 +1176,9 @@ msgid "" "attributes, which can be used when generating the plain text of a MIME " "message." msgstr "" +"Los objetos :class:`Message` pueden contener opcionalmente dos atributos de " +"instancia, los cuales pueden ser usados al generar el texto plano de un " +"mensaje MIME." #: ../Doc/library/email.compat32-message.rst:723 msgid "" @@ -789,6 +1189,12 @@ msgid "" "message, or when viewing the message in a non-MIME aware reader, this text " "can become visible." msgstr "" +"El formato de un documento MIME permite algo de texto entre la línea en " +"blanco que sigue a los encabezados y la primera cadena límite 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, " +"viendo el texto del mensaje en crudo o viendo el mensaje en un lector no " +"compatible con MIME, este texto puede volverse visible." #: ../Doc/library/email.compat32-message.rst:730 msgid "" @@ -801,12 +1207,23 @@ msgid "" "in the area between the headers and the first boundary. See :mod:`email." "parser` and :mod:`email.generator` for details." msgstr "" +"El atributo *preamble* contiene este texto de refuerzo adicional para " +"documentos MIME. Cuando el :class:`~email.parser.Parser` descubre algo de " +"texto después de los encabezados pero antes de la primera cadena límite, " +"asigna este texto al atributo *preamble* del mensaje. Cuando el :class:" +"`~email.generator.Generator` está escribiendo la representación de texto sin " +"formato de un mensaje MIME y puede encontrar el mensaje como un atributo " +"*preamble*, escribirá este texto en el área entre los encabezados y el " +"primer límite. Consulta :mod:`email.parser` y :mod:`email.generator` para " +"más detalles." #: ../Doc/library/email.compat32-message.rst:740 msgid "" "Note that if the message object has no preamble, the *preamble* attribute " "will be ``None``." msgstr "" +"Ten en cuenta que si el objeto de mensaje no tiene preámbulo, el atributo " +"*preamble* será ``None``." #: ../Doc/library/email.compat32-message.rst:746 msgid "" @@ -814,12 +1231,18 @@ msgid "" "except that it contains text that appears between the last boundary and the " "end of the message." msgstr "" +"El atributo *epilogue* actúa de la misma manera que el atributo *preamble*, " +"excepto que contiene texto que aparece entre el último límite y el fin del " +"mensaje." #: ../Doc/library/email.compat32-message.rst:750 msgid "" "You do not need to set the epilogue to the empty string in order for the :" "class:`~email.generator.Generator` to print a newline at the end of the file." msgstr "" +"No necesitas establecer el epílogo de la cadena vacía en orden para el :" +"class:`~email.generator.Generator` para imprimir una nueva línea al final " +"del archivo." #: ../Doc/library/email.compat32-message.rst:757 msgid "" @@ -827,3 +1250,6 @@ msgid "" "parsing this message. See :mod:`email.errors` for a detailed description of " "the possible parsing defects." msgstr "" +"El atributo *defects* contiene una lista de todos los problemas encontrados " +"al analizar este mensaje. Consulta :mod:`email.errors` para una descripción " +"detallada de los posibles defectos de análisis."