diff --git a/library/email.policy.po b/library/email.policy.po index af73fa3302..874ba0ee60 100644 --- a/library/email.policy.po +++ b/library/email.policy.po @@ -1,29 +1,31 @@ # Copyright (C) 2001-2020, Python Software Foundation # This file is distributed under the same license as the Python package. -# Maintained by the python-doc-es workteam. +# Maintained by the python-doc-es workteam. # docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/ # Check https://github.com/PyCampES/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: 2019-05-06 11:59-0400\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2020-08-25 07:58-0500\n" "Language-Team: python-doc-es\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"Last-Translator: Adolfo Hristo David Roque Gámez \n" +"Language: es_AR\n" +"X-Generator: Poedit 2.4\n" #: ../Doc/library/email.policy.rst:2 msgid ":mod:`email.policy`: Policy Objects" -msgstr "" +msgstr ":mod:`email.policy`: Objetos *Policy*" #: ../Doc/library/email.policy.rst:12 msgid "**Source code:** :source:`Lib/email/policy.py`" -msgstr "" +msgstr "**Código fuente:** :source:`Lib/email/policy.py`" #: ../Doc/library/email.policy.rst:16 msgid "" @@ -39,12 +41,27 @@ msgid "" "the standards, or that implement extensions you want to use in ways that " "violate the standards." msgstr "" +"El enfoque principal del paquete :mod:`email` es la gestión de mensajes de " +"correo electrónico como se describe por los varios RFC de correos " +"electrónicos y MIME. Sin embargo, el formato general de los mensajes de " +"correo electrónico (un bloque de campos de cabecera cada uno consistiendo en " +"un nombre seguido de dos puntos seguido de un valor, el bloque entero " +"seguido por una línea blanca y un 'cuerpo' arbitrario), es un formato que ha " +"encontrado utilidad fuera del campo de correos electrónicos. Algunos de " +"estos usos cumplen bastante cerca los RFC de correos electrónicos " +"principales, alguno no. Incluso cuando se trabajo con correos electrónicos, " +"hay veces cuando es deseable romper la estricta conformidad con los RFC, tal " +"como generar correos electrónicos que se integran con servidores de correos " +"electrónicos que no siguen los estándares, o que implementan extensiones que " +"quieres usar en formas que violan los estándares." #: ../Doc/library/email.policy.rst:28 msgid "" "Policy objects give the email package the flexibility to handle all these " "disparate use cases." msgstr "" +"Los objetos *policy* dan al paquete de correos electrónicos la flexibilidad " +"de manejar todos estos casos de uso diversos." #: ../Doc/library/email.policy.rst:31 msgid "" @@ -54,6 +71,12 @@ msgid "" "email package to alter the default behavior. The settable values and their " "defaults are described below." msgstr "" +"Un objeto :class:`Policy` encapsula un conjunto de atributos y métodos que " +"controlan el comportamiento de varios componentes del paquete de correos " +"electrónicos durante el uso. Las instancias :class:`Policy` pueden ser " +"pasadas a varias clases y métodos en el paquete de correos electrónicos para " +"alterar el comportamiento por defecto. Los valores que se pueden configurar " +"y sus valores por defecto se describen abajo." #: ../Doc/library/email.policy.rst:37 msgid "" @@ -65,6 +88,14 @@ msgid "" "some cases, including bug compatibility) with the pre-Python3.3 version of " "the email package." msgstr "" +"Hay una *policy* por defecto usada por todas las clases en el paquete de " +"correos electrónicos. Para todos las clases :mod:`~email.Parser` y las " +"funciones de conveniencia relacionadas, y para la clase :class:`~email." +"message.Message`, esta es una *policy* :class:`Compat32`, a través de sus " +"correspondientes instancias :const:`compat32` pre-definidas. Esta política " +"mantiene una compatibilidad (en algunos casos, compatibilidad con los bugs) " +"con el paquete de correos electrónicos de las versiones anteriores de " +"Python3.3." #: ../Doc/library/email.policy.rst:44 msgid "" @@ -72,6 +103,9 @@ msgid "" "EmailMessage` is the :class:`EmailPolicy` policy, via its pre-defined " "instance :data:`~default`." msgstr "" +"El valor por defecto para la palabra clave *policy* de :class:`~email." +"message.EmailMessage` es la *policy* :class:`EmailPolicy`, a través de su " +"instancia pre-definida :data:`~default`." #: ../Doc/library/email.policy.rst:48 msgid "" @@ -84,6 +118,14 @@ msgid "" "policy from the message by default, but you can also pass a specific policy " "to the generator that will override the one stored on the message object." msgstr "" +"Cuando un objeto :class:`~email.message.Message` o :class:`~email.message." +"EmailMessage` es creado, adquiere un *policy*. Si el mensaje es creado por " +"un :mod:`~email.parser`, un *policy* pasado al analizador será el *policy* " +"usado por el mensaje que cree. Si el mensaje es creado por el programa, " +"entonces el *policy* puede ser especificado cuando sea creado. Cuando un " +"mensaje es pasado a un :mod:`~email.generator`, el generador usa el *policy* " +"del mensaje por defecto, pero también puedes pasar un *policy* específico al " +"generador que anulará el que está guardado en el objeto mensaje." #: ../Doc/library/email.policy.rst:57 msgid "" @@ -93,6 +135,12 @@ msgid "" "which policy you want to use** when calling any of the classes and functions " "described in the :mod:`~email.parser` module." msgstr "" +"El valor por defecto del argumento por palabra clave *policy* para las " +"clases :mod:`email.parser` y las funciones de conveniencia del analizador " +"**se cambiarán** en una futura versión de Python. Por consiguiente, " +"**siempre debes especificar explícitamente qué policy quieres usar** cuando " +"se llama a cualquiera de las clases y funciones descritas en el módulo :mod:" +"`~email.parser`." #: ../Doc/library/email.policy.rst:63 msgid "" @@ -105,6 +153,16 @@ msgid "" "which implement the hooks that provide the standard behavior and the " "backward compatible behavior and features, respectively." msgstr "" +"La primera parte de esta documentación cubre las características de :class:" +"`Policy`, un :term:`abstract base class` que define las características que " +"son comunes a todos los objetos *policy*, incluyendo :const:`compat32`. " +"Esto incluye ciertos métodos gancho (*hook*) que son llamados internamente " +"por el paquete de correos electrónicos, que un *policy* personalizado puede " +"invalidar para obtener un comportamiento diferente. La segunda parte " +"describe las clases concretas :class:`EmailPolicy` y :class:`Compat32`, que " +"implementan los ganchos (*hooks*) que proporcionan el comportamiento " +"estándar y el comportamiento y características compatibles hacia atrás, " +"respectivamente." #: ../Doc/library/email.policy.rst:72 msgid "" @@ -113,6 +171,10 @@ msgid "" "class:`Policy` instance that is a copy of the original but with the " "specified attributes values changed." msgstr "" +"Las instancias :class:`Policy` son inmutables, pero pueden ser clonadas, " +"aceptando los mismos argumentos de palabra clave que el constructor de clase " +"y retorna una nueva instancia :class:`Policy` que es una copia del original " +"pero con los valores de atributos específicos cambiados." #: ../Doc/library/email.policy.rst:77 msgid "" @@ -120,6 +182,9 @@ msgid "" "from a file on disk and pass it to the system ``sendmail`` program on a Unix " "system:" msgstr "" +"Como un ejemplo, el siguiente código puede ser usado para leer un mensaje de " +"correo electrónico de un archivo en disco y pasarlo al programa de sistema " +"``sendmail`` en un sistema Unix:" #: ../Doc/library/email.policy.rst:113 msgid "" @@ -128,6 +193,11 @@ msgid "" "into ``sendmail's`` ``stdin``, where the default policy would use ``\\n`` " "line separators." msgstr "" +"Aquí le estamos diciendo a :class:`~email.generator.BytesGenerator` que use " +"los caracteres de separación de línea correctos de RFC cuando crea la cadena " +"binaria para alimentar a ``stding`` de ``sendmail`` (``sendmails's`` " +"``stdin``), donde el *policy* por defecto usaría separadores de línea ``" +"\\n``." #: ../Doc/library/email.policy.rst:118 msgid "" @@ -137,6 +207,12 @@ msgid "" "from the previous example and writes the message to a file using the native " "line separators for the platform on which it is running::" msgstr "" +"Algunos métodos del paquete de correos electrónicos aceptan un argumento de " +"palabra clave *policy*, permitiendo que el *policy* pueda ser anulado para " +"ese método. Por ejemplo, el siguiente código usa el método :meth:`~email." +"message.Message.as_bytes` del objeto *msg* del ejemplo anterior y escribe el " +"mensaje en un archivo usando los separadores de línea nativos para la " +"plataforma en el que esté corriendo::" #: ../Doc/library/email.policy.rst:129 msgid "" @@ -144,12 +220,17 @@ msgid "" "policy object whose settings are a combination of the non-default values of " "the summed objects::" msgstr "" +"Los objetos *policy* puede ser combinados usando el operador de adición, " +"produciendo un objeto *policy* cuya configuración es una combinación de los " +"valores que de los objetos sumados::" #: ../Doc/library/email.policy.rst:137 msgid "" "This operation is not commutative; that is, the order in which the objects " "are added matters. To illustrate::" msgstr "" +"Esta operación no es conmutativa; es decir, el orden en el que los objetos " +"son añadidos importa. Para ilustrar::" #: ../Doc/library/email.policy.rst:152 msgid "" @@ -158,6 +239,10 @@ msgid "" "implementation of the immutability property, the :meth:`clone` method, and " "the constructor semantics." msgstr "" +"Este es el :term:`abstract base class` para todas las clases *policy*. " +"Proporciona las implementaciones por defecto para un par de métodos " +"triviales, también como la implementación de las propiedades de " +"inmutabilidad, el método :meth:`clone`, y las semánticas del constructor." #: ../Doc/library/email.policy.rst:157 msgid "" @@ -167,12 +252,20 @@ msgid "" "value specified in the constructor will override the default value for the " "corresponding attribute." msgstr "" +"Se pueden pasar varios argumentos de palabra clave al constructor de una " +"clase *policy*. Los argumentos que pueden ser especificados son cualquier " +"propiedad que no sea método en esta clase, además de cualquier otra " +"propiedad adicional que no sea método en la clase concreta. Un valor " +"especificado en el constructor anulará el valor por defecto para los " +"atributos correspondientes." #: ../Doc/library/email.policy.rst:163 msgid "" "This class defines the following properties, and thus values for the " "following may be passed in the constructor of any policy class:" msgstr "" +"Esta clase define las siguientes propiedades, y por consiguiente los valores " +"a continuación pueden ser pasados al constructor de cualquier clase *policy*:" #: ../Doc/library/email.policy.rst:169 msgid "" @@ -180,6 +273,10 @@ msgid "" "end of line character(s). Default is 78, per :rfc:`5322`. A value of ``0`` " "or :const:`None` indicates that no line wrapping should be done at all." msgstr "" +"El tamaño máximo de cualquier línea en la salida serializada, sin contar el " +"fin de la línea de carácter(res). Por defecto es 78, por el :rfc:`5322`. Un " +"valor de ``0`` o :const:`None` indica que ningún envolvimiento de líneas " +"puede ser hecha en lo más mínimo." #: ../Doc/library/email.policy.rst:177 msgid "" @@ -187,16 +284,22 @@ msgid "" "is ``\\n`` because that's the internal end-of-line discipline used by " "Python, though ``\\r\\n`` is required by the RFCs." msgstr "" +"La cadena de caracteres a ser usada para terminar las líneas en una salida " +"serializada. El valor por defecto es ``\\n`` porque esa es la disciplina " +"del fin de línea interna usada por Python, aunque ``\\r\\n`` es requerida " +"por los RFCs." #: ../Doc/library/email.policy.rst:184 msgid "" "Controls the type of Content Transfer Encodings that may be or are required " "to be used. The possible values are:" msgstr "" +"Controla el tipo de Codificaciones de Transferencia de Contenido que pueden " +"ser o son necesarios para ser usados. Los valores posibles son:" #: ../Doc/library/email.policy.rst:190 msgid "``7bit``" -msgstr "" +msgstr "``7bit``" #: ../Doc/library/email.policy.rst:190 msgid "" @@ -204,10 +307,13 @@ msgid "" "necessary data will be encoded using either quoted-printable or base64 " "encoding." msgstr "" +"todos los datos deben ser \"compatibles con 7 bit (*7 bit clean*)\" (ASCII-" +"only). Esto significa que donde sea necesario, los datos serán codificados " +"usando o codificación imprimible entre comillas o base64." #: ../Doc/library/email.policy.rst:194 msgid "``8bit``" -msgstr "" +msgstr "``8bit``" #: ../Doc/library/email.policy.rst:194 msgid "" @@ -216,6 +322,11 @@ msgid "" "and :attr:`~EmailPolicy.utf8` below for exceptions), but body parts may use " "the ``8bit`` CTE." msgstr "" +"los datos no son limitados a ser compatibles con 7 bits (*7 bit clean*). Se " +"requiere que los datos en las cabeceras todavía sean sólo ASCII y por lo " +"tanto estarán codificadas (véase :meth:`fold_binary` y :attr:`~EmailPolicy." +"utf8` abajo por las excepciones), pero las partes del cuerpo pueden usar " +"``8bit`` CTE." #: ../Doc/library/email.policy.rst:200 msgid "" @@ -224,6 +335,10 @@ msgid "" "``Generator`` is operating under a policy that specifies ``cte_type=8bit``, " "it will act as if ``cte_type`` is ``7bit``." msgstr "" +"Un valor ``cte_type`` de ```8bit`` sólo trabaja con ``BytesGenerator``, no " +"``Generator``, porque las cadenas no pueden contener datos binarios. Si un " +"``Generator`` está operando bajo un *policy* que especifica " +"``cte_type=8bit``, actuará como si ``cte_type`` fuese ``7bit``." #: ../Doc/library/email.policy.rst:208 msgid "" @@ -231,6 +346,9 @@ msgid "" "const:`False` (the default), defects will be passed to the :meth:" "`register_defect` method." msgstr "" +"Si es :const:`True`, cualquier defecto encontrado será lanzado como error. " +"Si es :const:`False` (el valor por defecto), los defectos serán pasados al " +"método :meth:`register_defect`." #: ../Doc/library/email.policy.rst:215 msgid "" @@ -238,10 +356,14 @@ msgid "" "putting a ``>`` in front of them. This parameter is used when the message is " "being serialized by a generator. Default: :const:`False`." msgstr "" +"Si es :const:`True`, las líneas empezando con *\"From \"* en el cuerpo son " +"saltados al poner un ``>`` en frente de ellos. Este parámetro es usado " +"cuando el mensaje está siendo serializado por un generador. El valor por " +"defecto es: :const:`False`." #: ../Doc/library/email.policy.rst:220 msgid "The *mangle_from_* parameter." -msgstr "" +msgstr "El parámetro *mangle_from_*." #: ../Doc/library/email.policy.rst:226 msgid "" @@ -249,12 +371,18 @@ msgid "" "parser when building messages. Defaults to ``None``, in which case :class:" "`~email.message.Message` is used." msgstr "" +"Una función de fábrica para construir un nuevo objeto mensaje vacío. Usado " +"por el analizador cuando construye mensajes. Por defecto es ``None``, en " +"cuyo caso :class:`~email.message.Message` es usado." #: ../Doc/library/email.policy.rst:232 msgid "" "The following :class:`Policy` method is intended to be called by code using " "the email library to create policy instances with custom settings:" msgstr "" +"El siguiente método de :class:`Policy` está destinado a ser llamado por " +"código usando la librería de correos electrónicos para crear instancias de " +"*policy* con configuraciones personalizadas:" #: ../Doc/library/email.policy.rst:238 msgid "" @@ -262,6 +390,9 @@ msgid "" "as the current instance, except where those attributes are given new values " "by the keyword arguments." msgstr "" +"Retorna una nueva instancia de :class:`Policy` cuyos atributos tienen los " +"mismos valores que la instancia actual, excepto donde se le dan, a esos " +"atributos, nuevos valores por los argumentos de palabra clave." #: ../Doc/library/email.policy.rst:243 msgid "" @@ -269,12 +400,19 @@ msgid "" "and are not intended to be called by an application using the email package. " "A custom policy must implement all of these methods." msgstr "" +"Los métodos de :class:`Policy` restantes son llamados por el código de " +"paquete de correos electrónicos, y no están destinados a ser llamados por " +"una aplicación usando el paquete de correos electrónicos. Un *policy* " +"personalizado debe implementar todos estos métodos." #: ../Doc/library/email.policy.rst:250 msgid "" "Handle a *defect* found on *obj*. When the email package calls this method, " "*defect* will always be a subclass of :class:`~email.errors.Defect`." msgstr "" +"Trata un *defect* encontrado en *obj*. Cuando el paquete de correos " +"electrónicos llama a este método, *defect* siempre será una subclase de :" +"class:`~email.errors.Defect`." #: ../Doc/library/email.policy.rst:254 msgid "" @@ -282,12 +420,17 @@ msgid "" "is ``True``, *defect* is raised as an exception. If it is ``False`` (the " "default), *obj* and *defect* are passed to :meth:`register_defect`." msgstr "" +"La implementación por defecto verifica la bandera :attr:`raise_on_defect`. " +"Si es ``True``, *defect* es lanzado como una excepción. Si es ``False`` (el " +"valor por defecto), *obj* y *defect* son pasados a :meth:`register_defect`." #: ../Doc/library/email.policy.rst:261 msgid "" "Register a *defect* on *obj*. In the email package, *defect* will always be " "a subclass of :class:`~email.errors.Defect`." msgstr "" +"Registra un *defect* en *obj*. En el paquete de correos electrónicos, " +"*defect* será siempre una subclase de :class:`~email.errors.Defect`." #: ../Doc/library/email.policy.rst:264 msgid "" @@ -298,10 +441,17 @@ msgid "" "custom ``Message`` objects) should also provide such an attribute, otherwise " "defects in parsed messages will raise unexpected errors." msgstr "" +"La implementación por defecto llama al método ``append`` del atributo " +"``defects`` de *obj*. Cuando un paquete de correos electrónicos llama a :" +"attr:`handle_defect`, *obj* normalmente tendrá un atributo ``defects`` que " +"tiene un método ``append``. Los tipos de objetos personalizados usados con " +"el paquete de correos electrónicos (por ejemplo, objetos ``Message`` " +"personalizados) también deben proporcionar tal atributo, de otro modo, los " +"defectos en los mensajes analizados levantarán errores no esperados." #: ../Doc/library/email.policy.rst:274 msgid "Return the maximum allowed number of headers named *name*." -msgstr "" +msgstr "Retorna el máximo número permitido de cabeceras llamadas *name*." #: ../Doc/library/email.policy.rst:276 msgid "" @@ -310,6 +460,10 @@ msgid "" "or ``None``, and there are already a number of headers with the name *name* " "greater than or equal to the value returned, a :exc:`ValueError` is raised." msgstr "" +"Llamado cuando una cabecera es añadida a un objeto :class:`~email.message." +"EmailMessage` o :class:`~email.message.Message`. Si el valor retornado no " +"es ``0`` o ``None``, y ya hay un número de cabeceras con el nombre *name* " +"mayor o igual que el valor retornado, un :exc:`ValueError` es lanzado." #: ../Doc/library/email.policy.rst:282 msgid "" @@ -320,10 +474,19 @@ msgid "" "programmatically. (The limit is not observed by the parser, which will " "faithfully produce as many headers as exist in the message being parsed.)" msgstr "" +"Porque el comportamiento por defecto de ``Message.__setitem__`` es agregar " +"el valor a la lista de cabeceras, es fácil crear cabeceras duplicadas sin " +"darse cuenta. Este método permite que ciertas cabeceras sean limitadas en " +"el número de instancias de esa cabecera que puede ser agregada a ``Message`` " +"programáticamente. (El límite no es observado por el analizador, que " +"fielmente producirá tantas cabeceras como existen en el mensaje siendo " +"analizado.)" #: ../Doc/library/email.policy.rst:290 msgid "The default implementation returns ``None`` for all header names." msgstr "" +"La implementación por defecto retorna ``None`` para todos los nombres de " +"cabeceras." #: ../Doc/library/email.policy.rst:295 msgid "" @@ -334,6 +497,13 @@ msgid "" "``(name, value)`` tuple that is to be stored in the ``Message`` to represent " "the parsed header." msgstr "" +"El paquete de correos electrónicos llama a este método con una lista de " +"cadenas de caracteres, cada terminación de cadena con los caracteres de " +"separación de línea encontrada en la fuente siendo analizada. La primera " +"línea incluye el campo del nombre de cabecera y el separador. Todos los " +"espacios en blanco en la fuente son preservados. El método debe retornar la " +"tupla ``(name,value)`` que va a ser guardada en el ``Message`` para " +"representar la cabecera analizada." #: ../Doc/library/email.policy.rst:302 msgid "" @@ -343,15 +513,21 @@ msgid "" "(all line separator characters removed, but whitespace kept intact), " "stripped of leading whitespace." msgstr "" +"Si una implementación desea mantener compatibilidad con los *policy* del " +"paquete de correos electrónicos existentes, *name* debe ser el nombre con " +"las letras preservadas (todos los caracteres hasta el separador '``:``'), " +"mientras que *value* debe ser el valor desdoblado (todos los caracteres de " +"separación de líneas eliminados, pero los espacios en blanco intactos), " +"privado de espacios en blanco al comienzo." #: ../Doc/library/email.policy.rst:308 msgid "*sourcelines* may contain surrogateescaped binary data." -msgstr "" +msgstr "*sourcelines* puede contener datos binarios *surrogateescaped*." #: ../Doc/library/email.policy.rst:310 ../Doc/library/email.policy.rst:326 #: ../Doc/library/email.policy.rst:342 msgid "There is no default implementation" -msgstr "" +msgstr "No hay implementación por defecto" #: ../Doc/library/email.policy.rst:315 msgid "" @@ -361,6 +537,11 @@ msgid "" "method should return the ``(name, value)`` tuple that is to be stored in the " "``Message`` to represent the header." msgstr "" +"El paquete de correos electrónicos llama a este método con el nombre y valor " +"proporcionados por el programa de aplicación cuando la aplicación está " +"modificando un ``Message`` programáticamente (en lugar de un ``Message`` " +"creado por un analizador). El método debe retornar la tupla ``(name,value)`` " +"que va a ser almacenada en el ``Message`` para representar la cabecera." #: ../Doc/library/email.policy.rst:321 msgid "" @@ -368,6 +549,10 @@ msgid "" "package policies, the *name* and *value* should be strings or string " "subclasses that do not change the content of the passed in arguments." msgstr "" +"Si una implementación desea retener compatibilidad con los *policy* del " +"paquete de correos electrónicos existentes, el *name* y *value* deben ser " +"cadenas de caracteres o subclases de cadenas que no cambien el contenido de " +"los pasados en los argumentos." #: ../Doc/library/email.policy.rst:331 msgid "" @@ -379,12 +564,21 @@ msgid "" "method is passed the specific name and value of the header destined to be " "returned to the application." msgstr "" +"El paquete de correos electrónicos llama a este método con el *name* y " +"*valor* actualmente guardados en ``Message`` (el mensaje) cuando la cabecera " +"es solicitada por el programa de aplicación, y lo que sea que el método " +"retorne es lo que es pasado de vuelta a la aplicación como el valor de la " +"cabecera siendo recuperado. Note que puede haber más de una cabecera con el " +"mismo nombre guardado en ``Message``; el método es pasado al nombre " +"específico y valor de la cabecera destinado a ser retornado a la aplicación." #: ../Doc/library/email.policy.rst:339 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the value returned by the method." msgstr "" +"*value* puede contener datos binarios *surrogateescaped*. No debe haber " +"datos binarios *surrogateescaped* en el valor retornado por el método." #: ../Doc/library/email.policy.rst:347 msgid "" @@ -395,24 +589,38 @@ msgid "" "attr:`linesep` characters at the appropriate places. See :rfc:`5322` for a " "discussion of the rules for folding email headers." msgstr "" +"El paquete de correos electrónicos llama a este método con los *name* y " +"*value* actualmente guardados en ``Message`` para una cabecera dada. El " +"método debe retornar una cadena de caracteres que represente esa cabecera " +"\"doblada\" correctamente (de acuerdo a los ajustes del *policy*) al " +"componer *name* con *value* e insertar caracteres :attr:`linesep` en los " +"lugares apropiados. Véase :rfc:`5322` para una discusión de las reglas para " +"doblar cabeceras de correos electrónicos." #: ../Doc/library/email.policy.rst:354 msgid "" "*value* may contain surrogateescaped binary data. There should be no " "surrogateescaped binary data in the string returned by the method." msgstr "" +"*value* puede contener datos binarios *surrogateescaped*. No debe haber " +"datos binarios *surrogateescaped* en la cadena de caracteres retornada por " +"el método." #: ../Doc/library/email.policy.rst:360 msgid "" "The same as :meth:`fold`, except that the returned value should be a bytes " "object rather than a string." msgstr "" +"Igual que :meth:`fold`, excepto que el valor retornado debe ser un objeto " +"bytes en vez de una cadena de caracteres." #: ../Doc/library/email.policy.rst:363 msgid "" "*value* may contain surrogateescaped binary data. These could be converted " "back into binary data in the returned bytes object." msgstr "" +"*value* puede contener datos binarios *surrogateescaped*. Estos pueden ser " +"convertidos de vuelta a datos binarios en el objeto de bytes retornado." #: ../Doc/library/email.policy.rst:370 msgid "" @@ -420,6 +628,10 @@ msgid "" "compliant with the current email RFCs. These include (but are not limited " "to) :rfc:`5322`, :rfc:`2047`, and the current MIME RFCs." msgstr "" +"Este :class:`Policy` concreto proporciona el comportamiento que sirve para " +"cumplir con los RFCs actuales para correos electrónicos. Estos incluyen " +"(pero no están limitados a) :rfc:`5322`, :rfc:`2047`, y los actuales RFCs " +"MIME." #: ../Doc/library/email.policy.rst:374 msgid "" @@ -428,22 +640,32 @@ msgid "" "on the type of the field. The parsing and folding algorithm fully " "implement :rfc:`2047` and :rfc:`5322`." msgstr "" +"Esta *policy* incorpora nuevos analizadores de cabeceras y algoritmos de " +"doblado. En vez de cadenas de caracteres simples, las cabeceras son " +"subclases de ``str`` con atributos que dependen del tipo del campo. El " +"analizado y algoritmo de doblado implementan los :rfc:`2047` y :rfc:`5322` " +"por completo." #: ../Doc/library/email.policy.rst:379 msgid "" "The default value for the :attr:`~email.policy.Policy.message_factory` " "attribute is :class:`~email.message.EmailMessage`." msgstr "" +"El valor por defecto para el atributo :attr:`~email.policy.Policy." +"message_factory` es :class:`~email.message.EmailMessage`." #: ../Doc/library/email.policy.rst:382 msgid "" "In addition to the settable attributes listed above that apply to all " "policies, this policy adds the following additional attributes:" msgstr "" +"Además de los atributos que se pueden configurar listados arriba que aplican " +"a todas los *policies*, este *policy* añade los siguientes atributos " +"adicionales:" #: ../Doc/library/email.policy.rst:385 msgid "[1]_" -msgstr "" +msgstr "[1]_" #: ../Doc/library/email.policy.rst:390 msgid "" @@ -452,6 +674,12 @@ msgid "" "use ``utf-8`` encoding for headers. Messages formatted in this way may be " "passed to SMTP servers that support the ``SMTPUTF8`` extension (:rfc:`6531`)." msgstr "" +"Si es ``False``, se sigue el :rfc:`5322`, siendo compatible con caracteres " +"non-ASCII en las cabeceras al codificarlas como \"palabras codificadas\". " +"Si es ``True``, sigue el :rfc:`6532` y usa el formato de codificación " +"``utf-8`` para las cabeceras. Los mensajes formateados de esta manera puede " +"ser pasados a servidores SMTP que admitan la extensión ``SMTPUTF8`` (:rfc:" +"`6531`)." #: ../Doc/library/email.policy.rst:399 msgid "" @@ -460,36 +688,42 @@ msgid "" "indicates whether or not a generator should refold that value when " "transforming the message back into serialized form. The possible values are:" msgstr "" +"Si el valor para una cabecera en el objeto ``Message`` se originó de un :mod:" +"`~email.parser` (en lugar de ser establecido por el programa), este atributo " +"indica tanto si un generador debe redoblar ese valor cuando se transforma al " +"mensaje de vuelta a la forma serializada o no. Los valores posibles son:" #: ../Doc/library/email.policy.rst:406 msgid "``none``" -msgstr "" +msgstr "``none``" #: ../Doc/library/email.policy.rst:406 msgid "all source values use original folding" -msgstr "" +msgstr "todos los valores de la fuente usan el doblamiento original" #: ../Doc/library/email.policy.rst:408 msgid "``long``" -msgstr "" +msgstr "``long``" #: ../Doc/library/email.policy.rst:408 msgid "" "source values that have any line that is longer than ``max_line_length`` " "will be refolded" msgstr "" +"los valores de la fuente que tengan una línea que sea más grande que " +"``max_line_length`` serán redoblados" #: ../Doc/library/email.policy.rst:411 msgid "``all``" -msgstr "" +msgstr "``all``" #: ../Doc/library/email.policy.rst:411 msgid "all values are refolded." -msgstr "" +msgstr "todos los valores son redoblados." #: ../Doc/library/email.policy.rst:414 msgid "The default is ``long``." -msgstr "" +msgstr "El valor por defecto es ``long``." #: ../Doc/library/email.policy.rst:419 msgid "" @@ -501,6 +735,14 @@ msgid "" "field types, and the major MIME header field stypes. Support for additional " "custom parsing will be added in the future." msgstr "" +"Un invocable que toma dos argumentos, ``name`` y ``value``, donde ``name`` " +"es un nombre de campo de cabecera y ``value`` es un valor del campo de la " +"cabecera no doblado, y retorna una subclase de cadenas de caracteres que " +"representan la cabecera. Un valor por defecto ``header_factory`` (véase :" +"mod:`~email.headerregistry`) es proporcionado que admite el análisis " +"personalizado para los varios tipos de cabecera :RFC:`5322` de direcciones y " +"fechas, y los tipos del cabeceras MIME principales. La compatibilidad de " +"analizadores personalizados adicionales será agregada en el futuro." #: ../Doc/library/email.policy.rst:430 msgid "" @@ -512,12 +754,22 @@ msgid "" "that were passed to it as additional arguments. By default " "``content_manager`` is set to :data:`~email.contentmanager.raw_data_manager`." msgstr "" +"Un objeto con al menos dos métodos: get_content and set_content. Cuando los " +"métodos :meth:`~email.message.EmailMessage.get_content` o :meth:`~email." +"message.EmailMessage.set_content` del objeto :class:`~email." +"messageEmailMessage` son llamados, llama al método correspondiente de este " +"objeto, pasándole el mensaje objeto como su primer argumento, y cualquier " +"argumento o palabra clave que fuese pasado como un argumento adicional. Por " +"defecto ``content_manager`` se pone a :data:`~email.contentmanager." +"raw_data_manager`." #: ../Doc/library/email.policy.rst:442 ../Doc/library/email.policy.rst:600 msgid "" "The class provides the following concrete implementations of the abstract " "methods of :class:`Policy`:" msgstr "" +"La clase proporciona las siguientes implementaciones concretas de los " +"métodos abstractos de :class:`Policy`:" #: ../Doc/library/email.policy.rst:448 msgid "" @@ -525,6 +777,9 @@ msgid "" "attribute of the specialized class used to represent the header with the " "given name." msgstr "" +"Retorna el valor del atributo :attr:`~email.headerregistry.BaseHeader." +"max_count` de la clase especializada usada para representar la cabecera con " +"el nombre dado." #: ../Doc/library/email.policy.rst:456 ../Doc/library/email.policy.rst:606 msgid "" @@ -533,6 +788,10 @@ msgid "" "the first line, joining all subsequent lines together, and stripping any " "trailing carriage return or linefeed characters." msgstr "" +"El nombre es analizado como todo hasta el '``:``' y retornado inalterado. " +"El valor es determinado al remover los espacios en blanco al principio del " +"resto de la primera línea, juntando todas las subsecuentes líneas, y " +"removiendo cualquier carácter CR o LF." #: ../Doc/library/email.policy.rst:464 msgid "" @@ -542,6 +801,12 @@ msgid "" "resulting header object is returned as the value. In this case a " "``ValueError`` is raised if the input value contains CR or LF characters." msgstr "" +"El nombre es retornado inalterado. Si el valor de la entrada tiene un " +"atributo ``name`` y coincide con *name* ignorando mayúsculas y minúsculas, " +"el valor es retornado inalterado. Si no, el *name* y *value* son pasados a " +"``header_factory`` , y el objeto cabecera resultante es retornado como el " +"valor. En este caso un ``ValueError`` es lanzado si el valor de la entrada " +"contiene caracteres CR o LF." #: ../Doc/library/email.policy.rst:474 msgid "" @@ -551,6 +816,11 @@ msgid "" "returned. Any surrogateescaped bytes get turned into the unicode unknown-" "character glyph." msgstr "" +"Si el valor tiene un atributo ``name``, es retornado inalterado. De otra " +"manera el *name*, y el *value* con cualquier carácter CR o LF eliminado, son " +"pasados a la ``header_factory``, y el objeto cabecera resultante es " +"retornado. Cualquier byte *surrogateescaped* es convertido al glifo de " +"carácter desconocido de unicode." #: ../Doc/library/email.policy.rst:483 msgid "" @@ -563,6 +833,14 @@ msgid "" "Folding of a header object is done by calling its ``fold`` method with the " "current policy." msgstr "" +"El doblamiento de la cabecera es controlado por la configuración de " +"*policy* :attr:`refold_source`. Se considera que un valor es `source value` " +"(valor fuente) si y sólo si no tiene un atributo ``name```(tener un atributo " +"``name`` significa que es un objeto cabecera de algún tipo). Si un valor " +"fuente necesita ser redoblado de acuerdo a la política, es convertido en un " +"objeto cabecera al pasarle el *name* y *value* con cualquier carácter CR y " +"LF eliminado al ``header_factory``. El doblamiento de un objeto cabecera es " +"hecho al llamar a su método ``fold`` con el *policy* actual." #: ../Doc/library/email.policy.rst:492 msgid "" @@ -573,12 +851,21 @@ msgid "" "``refold_source`` setting, which causes the binary data to be CTE encoded " "using the ``unknown-8bit`` charset." msgstr "" +"Los valores fuente son separadas en líneas usando el método :meth:`~str." +"splitlines`. Si el valor no va a ser redoblado, las líneas son unidas de " +"nuevo usando el ``linesep`` del *policy* y retornadas. La excepción son las " +"líneas que contienen datos binarios non-ascii. En ese caso el valor es " +"redoblado a pesar de la configuración de ``refold_source``, que causa que " +"los datos binarios sean codificados CTE usando el juego de caracteres " +"(charset) ``unknown-8bit``." #: ../Doc/library/email.policy.rst:502 msgid "" "The same as :meth:`fold` if :attr:`~Policy.cte_type` is ``7bit``, except " "that the returned value is bytes." msgstr "" +"Igual que :meth:`fold` si :attr:`~Policy.cte_type` fuese ``7bit``, excepto " +"que el valor retornado son bytes." #: ../Doc/library/email.policy.rst:505 msgid "" @@ -587,6 +874,11 @@ msgid "" "the ``refold_header`` setting, since there is no way to know whether the " "binary data consists of single byte characters or multibyte characters." msgstr "" +"Si :attr:`~Policy.cte_type` es ``8bit``, los datos binarios non-ASCII son " +"convertidos de vuelta a bytes. Las cabeceras con datos binarios son " +"redoblados, sin considerar la configuración de ``refold_header``, ya que no " +"hay forma de saber si los datos binarios consisten en caracteres de un sólo " +"byte o caracteres con múltiples bytes." #: ../Doc/library/email.policy.rst:512 msgid "" @@ -595,6 +887,11 @@ msgid "" "these instances (in particular the ``HTTP`` instance) may be adjusted to " "conform even more closely to the RFCs relevant to their domains." msgstr "" +"Las siguientes instancias de :class:`EmailPolicy` proporcionan valores por " +"defecto apropiados para dominios de aplicaciones específicas. Note que en " +"el futuro el comportamiento de estas instancias (en particular la instancia " +"``HTTP``) puede ser ajustado para cumplir incluso más de cerca a los RFC " +"relevantes a sus dominios." #: ../Doc/library/email.policy.rst:520 msgid "" @@ -602,12 +899,18 @@ msgid "" "uses the standard Python ``\\n`` line endings rather than the RFC-correct ``" "\\r\\n``." msgstr "" +"Una instancia de ``EmailPolicy`` con todos los valores por defecto sin " +"cambiar. Este *policy* usa la terminación de línea ``\\n`` estándar de " +"Python en vez de correcto por el RFC ``\\r\\n``." #: ../Doc/library/email.policy.rst:527 msgid "" "Suitable for serializing messages in conformance with the email RFCs. Like " "``default``, but with ``linesep`` set to ``\\r\\n``, which is RFC compliant." msgstr "" +"Apropiado para la serialización de mensajes en cumplimiento con los RFC de " +"correos electrónicos. Como ``default``, pero con ``linesep`` puesto en ``\\r" +"\\n``, que es conforme con el RFC." #: ../Doc/library/email.policy.rst:534 msgid "" @@ -617,12 +920,20 @@ msgid "" "sender or recipient addresses have non-ASCII characters (the :meth:`smtplib." "SMTP.send_message` method handles this automatically)." msgstr "" +"Igual que ``SMTP`` excepto que :attr:`~EmailPolicy.utf8` es ``True``. Útil " +"para serializar mensajes a un almacén de mensajes sin usar palabras " +"codificadas en las cabeceras. Sólo debe ser utilizada para transmisiones " +"por SMTP si las direcciones del remitente o recipiente tienen caracteres non-" +"ASCII (el método :meth:`smtplib.SMTP.send_message` gestiona esto " +"automáticamente)." #: ../Doc/library/email.policy.rst:543 msgid "" "Suitable for serializing headers with for use in HTTP traffic. Like " "``SMTP`` except that ``max_line_length`` is set to ``None`` (unlimited)." msgstr "" +"Apropiado para serializar cabeceras con uso en tráfico de HTTP. Como " +"``SMTP`` excepto que ``max_line_length`` es puesto en ``None`` (ilimitado)." #: ../Doc/library/email.policy.rst:549 msgid "" @@ -630,6 +941,9 @@ msgid "" "``raise_on_defect`` is set to ``True``. This allows any policy to be made " "strict by writing::" msgstr "" +"Instancias de conveniencia. Igual que ``default`` excepto que " +"``raise_of_defect`` es puesto en ``True``. Esto permite que cualquier " +"*policy* sea hecho estricto al escribir::" #: ../Doc/library/email.policy.rst:556 msgid "" @@ -637,18 +951,25 @@ msgid "" "of the email package is changed from the Python 3.2 API in the following " "ways:" msgstr "" +"Con todos estos :class:`EmailPolicies <.EmailPolicy>`, el API efectivo del " +"paquete de correos electrónicos es cambiado del API de Python 3.2 en las " +"siguientes maneras:" #: ../Doc/library/email.policy.rst:559 msgid "" "Setting a header on a :class:`~email.message.Message` results in that header " "being parsed and a header object created." msgstr "" +"Estableciendo una cabecera en una :class:`~email.message.Message` resulta en " +"que la cabecera sea analizada y un objeto cabecera sea creado." #: ../Doc/library/email.policy.rst:562 msgid "" "Fetching a header value from a :class:`~email.message.Message` results in " "that header being parsed and a header object created and returned." msgstr "" +"Buscar una valor de cabecera de un :class:`~email.message.Message` resulta " +"en que la cabecera sea analizada y un objeto cabecera sea creado y retornado." #: ../Doc/library/email.policy.rst:566 msgid "" @@ -656,6 +977,10 @@ msgid "" "settings, is folded using an algorithm that fully implements the RFC folding " "algorithms, including knowing where encoded words are required and allowed." msgstr "" +"Cualquier objeto cabecera, o cualquier cabecera que sea redoblada debido a " +"las configuraciones del *policy*, es doblado usando un algoritmo que " +"implementa el algoritmo de doblado del RFC por completo, incluyendo saber " +"dónde las palabras codificadas son requeridas y permitidas." #: ../Doc/library/email.policy.rst:571 msgid "" @@ -666,12 +991,21 @@ msgid "" "created, using a unicode string, and the policy will take care of converting " "the unicode string into the correct RFC encoded form." msgstr "" +"Desde la vista de la aplicación, significa que cualquier cabecera obtenida a " +"través de :class:`~email.message.EmailMessage` es un objeto cabecera con " +"atributos extra, cuyo valor de cadena es el valor Unicode de la cabecera " +"completamente decodificada. Asimismo, se le puede asignar un nuevo valor a " +"una cabecera, o a una nueva cabecera creada, usando una cadena de caracteres " +"Unicode, y el *policy* se ocupará de convertir la cadena Unicode en la forma " +"decodificada correcta según el RFC." #: ../Doc/library/email.policy.rst:578 msgid "" "The header objects and their attributes are described in :mod:`~email." "headerregistry`." msgstr "" +"Los objetos cabecera y sus atributos son descritos en :mod:`~email." +"headerrregistry`." #: ../Doc/library/email.policy.rst:585 msgid "" @@ -681,20 +1015,28 @@ msgid "" "`compat32`, that is used as the default policy. Thus the default behavior " "of the email package is to maintain compatibility with Python 3.2." msgstr "" +"Este :class:`Policy` concreto es el *policy* compatible hacia atrás. Replica " +"el comportamiento del paquete de correos electrónicos en Python 3.2. El " +"módulo :mod:`~email.policy` también define una instancia de esta clase, :" +"const:`compat32`, que es usado como el *policy* por defecto. Por " +"consiguiente, el comportamiento por defecto del paquete de correos " +"electrónicos es mantener compatibilidad con Python 3.2." #: ../Doc/library/email.policy.rst:591 msgid "" "The following attributes have values that are different from the :class:" "`Policy` default:" msgstr "" +"Los siguientes atributos tienen valores que son diferentes del :class:" +"`Policy` por defecto:" #: ../Doc/library/email.policy.rst:597 msgid "The default is ``True``." -msgstr "" +msgstr "El valor por defecto es ``True``." #: ../Doc/library/email.policy.rst:614 msgid "The name and value are returned unmodified." -msgstr "" +msgstr "El nombre y valor son retornados inalterados." #: ../Doc/library/email.policy.rst:619 msgid "" @@ -702,6 +1044,9 @@ msgid "" "header.Header` object using the ``unknown-8bit`` charset. Otherwise it is " "returned unmodified." msgstr "" +"Si el valor contiene datos binarios, es convertido a un objeto :class:" +"`~email.header.Header` usando el juego de caracteres (*charset*) " +"``unknown-8bit``. De otro modo, es retornado sin modificar." #: ../Doc/library/email.policy.rst:626 msgid "" @@ -710,6 +1055,11 @@ msgid "" "resulting line to the ``max_line_length``. Non-ASCII binary data are CTE " "encoded using the ``unknown-8bit`` charset." msgstr "" +"Las cabeceras son dobladas usando el algoritmo de doblado de :class:`~email." +"header.Header`, lo que preserva los saltos de líneas existentes en el valor, " +"y envuelve cada línea resultante hasta el ``max_line_length``. Los datos " +"binarios Non-ASCII son codificados por *CTE* usando el juego de caracteres " +"(*charset*) ``unknown-8bit``." #: ../Doc/library/email.policy.rst:634 msgid "" @@ -720,19 +1070,31 @@ msgid "" "Otherwise the original source header is used, with its existing line breaks " "and any (RFC invalid) binary data it may contain." msgstr "" +"Las cabeceras son dobladas usando el algoritmo de doblado :class:`~email." +"header.Header`, lo que preserva los saltos de línea existentes en el valor, " +"y envuelve cada línea resultante hasta ``max_line_length``. Si ``cte_type`` " +"es ``7bit``, los datos binarios non-ascii son codificados por *CTE* usando " +"el juego de caracteres ``unknown-8bit``. De otro modo, la cabecera fuente " +"original es usada, con sus saltos de línea existentes y cualquier (inválido " +"según el RFC) dato binario que puede contener." #: ../Doc/library/email.policy.rst:644 msgid "" "An instance of :class:`Compat32`, providing backward compatibility with the " "behavior of the email package in Python 3.2." msgstr "" +"Una instancia de :class:`Compat32`, proporcionando compatibilidad hacia " +"atrás con el comportamiento del paquete de correos electrónicos en Python " +"3.2." #: ../Doc/library/email.policy.rst:649 msgid "Footnotes" -msgstr "" +msgstr "Notas al pie de página" #: ../Doc/library/email.policy.rst:650 msgid "" "Originally added in 3.3 as a :term:`provisional feature `." msgstr "" +"Se añadió originalmente en 3.3 como un :term:`característica provisional " +"`."