diff --git a/library/nntplib.po b/library/nntplib.po index 5d66a57d80..3c7c354836 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -6,51 +6,64 @@ # 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-26 08:46-0300\n" "Language-Team: python-doc-es\n" "MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.8.0\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"Last-Translator: \n" +"Language: es\n" +"X-Generator: Poedit 2.4.2\n" #: ../Doc/library/nntplib.rst:2 msgid ":mod:`nntplib` --- NNTP protocol client" -msgstr "" +msgstr ":mod:`nntplib` — Protocolo de cliente NNTP" #: ../Doc/library/nntplib.rst:7 msgid "**Source code:** :source:`Lib/nntplib.py`" -msgstr "" +msgstr "**Código fuente:** :source:`Lib/nntplib.py`" #: ../Doc/library/nntplib.rst:15 msgid "" "This module defines the class :class:`NNTP` which implements the client side " -"of the Network News Transfer Protocol. It can be used to implement a news " -"reader or poster, or automated news processors. It is compatible with :rfc:" -"`3977` as well as the older :rfc:`977` and :rfc:`2980`." +"side of the Network News Transfer Protocol. It can be used to implement a " +"news reader or poster, or automated news processors. It is compatible with :" +"rfc:`3977` as well as the older :rfc:`977` and :rfc:`2980`." msgstr "" +"Este módulo define la clase :class:`NNTP` que implementa el lado del cliente " +"del protocolo para la transferencia de noticias en red. Se puede utilizar " +"para implementar un lector o publicador de noticias, o procesadores de " +"noticias automatizados. Es compatible con :rfc:`3977`, así como con el " +"anterior :rfc:`977` y :rfc:`2980`." #: ../Doc/library/nntplib.rst:20 msgid "" "Here are two small examples of how it can be used. To list some statistics " "about a newsgroup and print the subjects of the last 10 articles::" msgstr "" +"Aquí hay dos pequeños ejemplos de cómo se puede utilizar. Para enumerar " +"algunas estadísticas sobre un grupo de noticias e imprimir los temas de los " +"últimos 10 artículos::" #: ../Doc/library/nntplib.rst:44 msgid "" "To post an article from a binary file (this assumes that the article has " "valid headers, and that you have right to post on the particular newsgroup)::" msgstr "" +"Para publicar un artículo desde un archivo binario (esto supone que el " +"artículo tiene encabezados válidos y que tienes permitido publicar en el " +"grupo de noticias en particular)::" #: ../Doc/library/nntplib.rst:54 msgid "The module itself defines the following classes:" -msgstr "" +msgstr "El módulo en sí define las siguientes clases:" #: ../Doc/library/nntplib.rst:59 msgid "" @@ -69,17 +82,36 @@ msgid "" "`with` statement to unconditionally consume :exc:`OSError` exceptions and to " "close the NNTP connection when done, e.g.:" msgstr "" +"Retorna un nuevo objeto :class:`NNTP` que representa una conexión con el " +"servidor NNTP ejecutándose en el host *host*, escuchando en el puerto " +"*port*. Se puede especificar un *timeout* opcional para la conexión de " +"socket. Si se proporcionan las credenciales opcionales *user* y *password*, " +"o si hay credenciales adecuadas en :file:`/.netrc` y el indicador opcional " +"*usenetrc* es verdadero, los comandos ``AUTHINFO USER`` y ``AUTHINFO PASS`` " +"se utilizan para identificar y autenticar al usuario en el servidor. Si el " +"indicador opcional *readermode* es verdadero, se envía un comando ``mode " +"reader`` antes de que se realice la autenticación. El modo de lector a veces " +"es necesario si se conecta a un servidor NNTP en el equipo local y tiene la " +"intención de llamar a comandos específicos del lector, como ``group``. Si " +"obtienes un valor inesperado :exc:`NNTPPermanentError`, es posible que debas " +"establecer *readermode*. La clase :class:`NNTP` admite la instrucción :" +"keyword:`with` para consumir incondicionalmente las excepciones :exc:" +"`OSError` y para cerrar la conexión NNTP cuando haya terminado, e.g.:" #: ../Doc/library/nntplib.rst:83 ../Doc/library/nntplib.rst:111 msgid "" "Raises an :ref:`auditing event ` ``nntplib.connect`` with " "arguments ``self``, ``host``, ``port``." msgstr "" +"Genera un :ref:`evento de auditoría ` ``nntplib.connect`` con los " +"argumentos ``self``, ``host``, ``port``." msgid "" "Raises an :ref:`auditing event ` ``nntplib.putline`` with " "arguments ``self``, ``line``." msgstr "" +"Genera un :ref:`evento de auditoría ` ``nntplib.putline`` con los " +"argumentos ``self``, ``line``." #: ../Doc/library/nntplib.rst:86 ../Doc/library/nntplib.rst:114 msgid "" @@ -87,14 +119,17 @@ msgid "" "putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes " "about to be sent to the remote host." msgstr "" +"Todos los comandos generarán un :ref:`evento de auditoría ` " +"``nntplib.putline`` con los argumentos ``self`` y ``line``, donde ``line`` " +"es los bytes a punto de ser enviados al host remoto." #: ../Doc/library/nntplib.rst:90 msgid "*usenetrc* is now ``False`` by default." -msgstr "" +msgstr "*usenetrc* es ahora ``False`` por defecto." #: ../Doc/library/nntplib.rst:93 msgid "Support for the :keyword:`with` statement was added." -msgstr "" +msgstr "El soporte para la declaración :keyword:`with` fue añadido." #: ../Doc/library/nntplib.rst:98 msgid "" @@ -106,18 +141,32 @@ msgid "" "for best practices. All other parameters behave the same as for :class:" "`NNTP`." msgstr "" +"Retorna un nuevo objeto :class:`NNTP_SSL`, que representa una conexión " +"cifrada con el servidor NNTP ejecutándose en el host *host*, escuchando en " +"el puerto *port*. Los objetos :class:`NNTP_SSL` tienen los mismos métodos " +"que los objetos :class:`NNTP`. Si se omite el *port* se utiliza el puerto " +"563 (NNTPS). *ssl_context* también es opcional, y también el objeto :class:" +"`~ssl.SSLContext`. Por favor, lea :ref:`ssl-security` para conocer las " +"buenas prácticas. Todos los demás parámetros se comportan igual que para :" +"class:`NNTP`." #: ../Doc/library/nntplib.rst:106 msgid "" "Note that SSL-on-563 is discouraged per :rfc:`4642`, in favor of STARTTLS as " "described below. However, some servers only support the former." msgstr "" +"Tenga en cuenta que SSL-on-563 no es recomendado por :rfc:`4642`, en favor " +"de STARTTLS como se describe abajo. Sin embargo, algunos servidores solo " +"admiten el primero." #: ../Doc/library/nntplib.rst:120 msgid "" "The class now supports hostname check with :attr:`ssl.SSLContext." "check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)." msgstr "" +"La clase ahora admite la verificación del nombre de host con :attr:`ssl." +"SSLContext.check_hostname` e *Indicador del nombre del servidor* (SNI por " +"sus siglas en inglés, consulte :data:`ssl.HAS_SNI`)." #: ../Doc/library/nntplib.rst:127 msgid "" @@ -125,48 +174,62 @@ msgid "" "for all exceptions raised by the :mod:`nntplib` module. Instances of this " "class have the following attribute:" msgstr "" +"Derivado de la excepción estándar :exc:`Exception`, esta es la clase base " +"para todas las excepciones generadas por el módulo :mod:`nntplib`. Las " +"instancias de esta clase tienen el siguiente atributo:" #: ../Doc/library/nntplib.rst:133 msgid "The response of the server if available, as a :class:`str` object." msgstr "" +"La respuesta del servidor, si está disponible, como un objeto :class:`str`." #: ../Doc/library/nntplib.rst:138 msgid "Exception raised when an unexpected reply is received from the server." msgstr "" +"Excepción generada cuando se recibe una respuesta inesperada del servidor." #: ../Doc/library/nntplib.rst:143 msgid "" "Exception raised when a response code in the range 400--499 is received." msgstr "" +"Excepción generada cuando se recibe un código de respuesta dentro del rango " +"del 400--499." #: ../Doc/library/nntplib.rst:148 msgid "" "Exception raised when a response code in the range 500--599 is received." msgstr "" +"Excepción generada cuando se recibe un código de respuesta dentro del rango " +"del 500--599." #: ../Doc/library/nntplib.rst:153 msgid "" "Exception raised when a reply is received from the server that does not " "begin with a digit in the range 1--5." msgstr "" +"Excepción generada cuando se recibe una respuesta del servidor que no " +"comienza con un dígito dentro del rango 1--5." #: ../Doc/library/nntplib.rst:159 msgid "Exception raised when there is some error in the response data." msgstr "" +"Excepción generada cuando hay algún error en los datos de la respuesta." #: ../Doc/library/nntplib.rst:165 msgid "NNTP Objects" -msgstr "" +msgstr "Objetos NNTP" #: ../Doc/library/nntplib.rst:167 msgid "" "When connected, :class:`NNTP` and :class:`NNTP_SSL` objects support the " "following methods and attributes." msgstr "" +"Cuando están conectados, los objetos :class:`NNTP` y :class:`NNTP_SSL` " +"admiten los siguientes métodos y atributos." #: ../Doc/library/nntplib.rst:171 msgid "Attributes" -msgstr "" +msgstr "Atributos" #: ../Doc/library/nntplib.rst:175 msgid "" @@ -174,16 +237,21 @@ msgid "" "server. In practice, this should be ``2`` for servers advertising :rfc:" "`3977` compliance and ``1`` for others." msgstr "" +"Un entero que representa la versión del protocolo NNTP compatible con el " +"servidor. En la práctica, esto debería ser ``2`` para los servidores que " +"anuncian el cumplimiento :rfc:`3977` y ``1`` para otros." #: ../Doc/library/nntplib.rst:183 msgid "" "A string describing the software name and version of the NNTP server, or :" "const:`None` if not advertised by the server." msgstr "" +"Cadena que describe el nombre de software y la versión del servidor NNTP, o :" +"const:`None` si el servidor no lo anuncia." #: ../Doc/library/nntplib.rst:189 msgid "Methods" -msgstr "" +msgstr "Métodos" #: ../Doc/library/nntplib.rst:191 msgid "" @@ -192,6 +260,10 @@ msgid "" "digit code. If the server's response indicates an error, the method raises " "one of the above exceptions." msgstr "" +"La *response* que es retornada como el primer elemento de la tupla de " +"retorno de casi todos los métodos es la respuesta del servidor: una cadena " +"que comienza con un código de tres dígitos. Si la respuesta del servidor " +"indica un error, el método genera una de las excepciones anteriores." #: ../Doc/library/nntplib.rst:196 msgid "" @@ -202,18 +274,29 @@ msgid "" "(except for the response line and the terminating dot) to the file; any list " "of lines, tuples or objects that the method normally returns will be empty." msgstr "" +"Muchos de los métodos siguientes toman un argumento opcional de solamente " +"palabra clave *file*. Cuando se proporciona el argumento *file*, debe ser " +"un :term:`file object` abierto para la escritura binaria o el nombre de un " +"archivo en disco a ser escrito. El método escribirá los datos retornados por " +"el servidor (excepto la línea de respuesta y el punto de terminación) en el " +"archivo; cualquier lista de líneas, tuplas u objetos que el método retorna " +"normalmente estará vacía." #: ../Doc/library/nntplib.rst:203 msgid "" "Many of the following methods have been reworked and fixed, which makes them " "incompatible with their 3.1 counterparts." msgstr "" +"Muchos de los siguientes métodos se han rediseñado y corregido, lo que los " +"hace incompatibles con sus contrapartes 3.1." #: ../Doc/library/nntplib.rst:210 msgid "" "Send a ``QUIT`` command and close the connection. Once this method has been " "called, no other methods of the NNTP object should be called." msgstr "" +"Envía un comando ``QUIT`` y cierra la conexión. Una vez que se ha invocado " +"este método, no se debe invocar ningún otro método del objeto NNTP." #: ../Doc/library/nntplib.rst:216 msgid "" @@ -221,6 +304,9 @@ msgid "" "connection. (This message sometimes contains disclaimers or help " "information that may be relevant to the user.)" msgstr "" +"Retorna el mensaje de bienvenida enviado por el servidor en respuesta a la " +"conexión inicial. (Este mensaje a veces contiene aclaraciones o información " +"de ayuda que puede ser relevante para el usuario.)" #: ../Doc/library/nntplib.rst:223 msgid "" @@ -229,6 +315,10 @@ msgid "" "values. On legacy servers which don't understand the ``CAPABILITIES`` " "command, an empty dictionary is returned instead." msgstr "" +"Retorna las capacidades :rfc:`3977` anunciadas por el servidor, como una " +"instancia :class:`dict` mapeando nombres de capacidades a listas de valores " +"(posiblemente vacías). En los servidores heredados que no entienden el " +"comando ``CAPABILITIES``, se retorna un diccionario vacío en su lugar." #: ../Doc/library/nntplib.rst:237 msgid "" @@ -236,6 +326,9 @@ msgid "" "*password* are ``None`` and *usenetrc* is true, credentials from ``~/." "netrc`` will be used if possible." msgstr "" +"Envía comandos ``AUTHINFO`` con el nombre de usuario y la contraseña. Si " +"*user* y *password* son ``None`` y *usenetrc* es verdadero, se utilizarán " +"las credenciales de ``~/.netrc`` si su uso es posible." #: ../Doc/library/nntplib.rst:241 msgid "" @@ -244,6 +337,11 @@ msgid "" "unnecessary. To force authentication to be delayed, you must not set *user* " "or *password* when creating the object, and must set *usenetrc* to False." msgstr "" +"A menos que se retrase intencionalmente, el inicio de sesión se realiza " +"normalmente durante la inicialización del objeto :class:`NNTP` y no es " +"necesario invocar esta función por separado. Para forzar el retraso de la " +"autenticación, no debes establecer *user* o *password* al crear el objeto y " +"debes establecer *usenetrc* en *False*." #: ../Doc/library/nntplib.rst:252 msgid "" @@ -251,6 +349,10 @@ msgid "" "connection. The *context* argument is optional and should be a :class:`ssl." "SSLContext` object. Please read :ref:`ssl-security` for best practices." msgstr "" +"Envía un comando ``STARTTLS``. Esto habilitará el cifrado en la conexión " +"NNTP. El argumento *context* es opcional y debe ser el objeto :class:`ssl. " +"SSLContext`. Por favor lea :ref:`ssl-security` para conocer las buenas " +"prácticas." #: ../Doc/library/nntplib.rst:257 msgid "" @@ -259,12 +361,20 @@ msgid "" "class:`NNTP` object initialization. See :meth:`NNTP.login` for information " "on suppressing this behavior." msgstr "" +"Tenga en cuenta que esto no se puede hacer después de que se haya " +"transmitido la información de autenticación y la autenticación se produce de " +"forma predeterminada, si es posible, durante la inicialización de un objeto :" +"class:`NNTP`. Consulte :meth:`NNTP.login` para obtener información sobre " +"cómo suprimir este comportamiento." #: ../Doc/library/nntplib.rst:264 msgid "" "The method now supports hostname check with :attr:`ssl.SSLContext." "check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)." msgstr "" +"El método ahora admite la comprobación del nombre de host con :attr:`ssl. " +"SSLContext.check_hostname` y *Indicador del nombre del servidor* (SNI por " +"sus siglas en inglés, consulte :data:`ssl.HAS_SNI`)." #: ../Doc/library/nntplib.rst:271 msgid "" @@ -274,6 +384,11 @@ msgid "" "are new since the given *date*. If *file* is supplied, though, then *groups* " "will be empty." msgstr "" +"Envía un comando ``NEWGROUPS``. El argumento *date* debe ser un objeto :" +"class:`datetime.date` o :class:`datetime.datetime`. Retorna un par " +"``(response, groups)`` donde *groups* es una lista que representa los grupos " +"que son nuevos desde la fecha determinada. Sin embargo, si se proporciona " +"*file*, entonces *groups* estará vacío." #: ../Doc/library/nntplib.rst:287 msgid "" @@ -281,10 +396,16 @@ msgid "" "*date* has the same meaning as for :meth:`newgroups`. Return a pair " "``(response, articles)`` where *articles* is a list of message ids." msgstr "" +"Envía un comando ``NEWNEWS``. Aquí, *group* es un nombre de grupo o ``'*'``, " +"y *date* tiene el mismo significado que para :meth:`newgroups`. Retorna un " +"par ``(response, articles)`` donde *articles* es una lista de " +"identificadores de mensaje." #: ../Doc/library/nntplib.rst:291 msgid "This command is frequently disabled by NNTP server administrators." msgstr "" +"Este comando es inhabilitado frecuentemente por los administradores del " +"servidor NNTP." #: ../Doc/library/nntplib.rst:296 msgid "" @@ -295,36 +416,49 @@ msgid "" "where *group* is a group name, *last* and *first* are the last and first " "article numbers, and *flag* usually takes one of these values:" msgstr "" +"Envía un comando ``LIST`` o ``LIST ACTIVE``. Retorna un par ``(response, " +"list)`` donde *list* es una lista de tuplas que representan todos los grupos " +"disponibles desde este servidor NNTP, opcionalmente coincidiendo con el " +"patrón de cadena *group_pattern*. Cada tupla tiene el formato ``(group, " +"last, first, flag)``, donde *group* es un nombre de grupo, *last* y *first* " +"son los últimos y primeros números de artículo, y *flag* suele tomar uno de " +"estos valores:" #: ../Doc/library/nntplib.rst:304 msgid "``y``: Local postings and articles from peers are allowed." -msgstr "" +msgstr "``y``: Se permiten publicaciones locales y artículos de pares." #: ../Doc/library/nntplib.rst:305 msgid "``m``: The group is moderated and all postings must be approved." msgstr "" +"``m``: El grupo está moderado y todas las publicaciones deben ser aprobadas." #: ../Doc/library/nntplib.rst:306 msgid "``n``: No local postings are allowed, only articles from peers." -msgstr "" +msgstr "``n``: No se permiten publicaciones locales, solo artículos de pares." #: ../Doc/library/nntplib.rst:307 msgid "``j``: Articles from peers are filed in the junk group instead." msgstr "" +"``j``: Los artículos de pares se archivan en el grupo de basura en su lugar." #: ../Doc/library/nntplib.rst:308 msgid "``x``: No local postings, and articles from peers are ignored." msgstr "" +"``x``: No hay publicaciones locales y los artículos de pares son ignorados." #: ../Doc/library/nntplib.rst:309 msgid "``=foo.bar``: Articles are filed in the ``foo.bar`` group instead." msgstr "" +"``=foo.bar``: Los artículos se archivan en el grupo ``foo.bar`` en su lugar." #: ../Doc/library/nntplib.rst:311 msgid "" "If *flag* has another value, then the status of the newsgroup should be " "considered unknown." msgstr "" +"Si *flag* tiene otro valor, el estado del grupo de noticias debe " +"considerarse como desconocido." #: ../Doc/library/nntplib.rst:314 msgid "" @@ -332,10 +466,13 @@ msgid "" "not specified. It is best to cache the results offline unless you really " "need to refresh them." msgstr "" +"Este comando puede devolver resultados muy grandes, especialmente si no se " +"especifica *group_pattern*. Es mejor almacenar en caché los resultados sin " +"conexión a menos que realmente necesite actualizarlos." #: ../Doc/library/nntplib.rst:318 msgid "*group_pattern* was added." -msgstr "" +msgstr "*group_pattern* fue añadido." #: ../Doc/library/nntplib.rst:324 msgid "" @@ -344,6 +481,11 @@ msgid "" "wildcard strings). Return a pair ``(response, descriptions)``, where " "*descriptions* is a dictionary mapping group names to textual descriptions." msgstr "" +"Envía un comando ``LIST NEWSGROUPS``, donde *grouppattern* es una cadena " +"comodín como se especifica en :rfc:`3977` (es esencialmente lo mismo que las " +"cadenas comodín de shell DOS o UNIX). Retorna un par ``(response, " +"descriptions)``, donde *descriptions* es un diccionario que asigna nombres " +"de grupos a descripciones textuales." #: ../Doc/library/nntplib.rst:338 msgid "" @@ -351,12 +493,17 @@ msgid "" "matches (if 'group' is a real wildmat string), return the first match. If " "no group matches, return an empty string." msgstr "" +"Obtiene una descripción para un único grupo *group*. Si más de un grupo " +"coincide (si *'group'* es una cadena comodín real), retorna la primera " +"coincidencia. Si ningún grupo coincide, retorna una cadena vacía." #: ../Doc/library/nntplib.rst:342 msgid "" "This elides the response code from the server. If the response code is " "needed, use :meth:`descriptions`." msgstr "" +"Esto elude el código de respuesta del servidor. Si necesita el código de " +"respuesta, use :meth:`descriptions`." #: ../Doc/library/nntplib.rst:348 msgid "" @@ -366,6 +513,12 @@ msgid "" "articles in the group, *first* is the first article number in the group, " "*last* is the last article number in the group, and *name* is the group name." msgstr "" +"Envía un comando ``GROUP``, donde *name* es el nombre del grupo. El grupo se " +"selecciona como el grupo actual, si este existe. Retorna una tupla " +"``(response, count, first, last, name)`` donde *count* es el número " +"(estimado) de artículos en el grupo, *first* es el primer número de artículo " +"del grupo, *last* es el último número de artículo en el grupo y *name* es el " +"nombre del grupo." #: ../Doc/library/nntplib.rst:358 msgid "" @@ -376,6 +529,13 @@ msgid "" "starting from *first* to the last article in the current group, or :const:" "`None` to select the current article in the current group." msgstr "" +"Envía un comando ``OVER`` o un comando ``XOVER`` en servidores heredados. " +"*message_spec* puede ser una cadena que represente un identificador de " +"mensaje o una tupla de números ``(first, None)`` que indique un rango de " +"artículos en el grupo actual, o una tupla ``(first, None)`` que indique un " +"rango de artículos comenzando desde *first* hasta el último artículo del " +"grupo actual, o :const:`None` para seleccionar el artículo actual en el " +"grupo actual." #: ../Doc/library/nntplib.rst:365 msgid "" @@ -387,39 +547,57 @@ msgid "" "items (the key is then the metadata name prepended with ``\":\"``). The " "following items are guaranteed to be present by the NNTP specification:" msgstr "" +"Retorna un par ``(response, overviews)``. *overviews* es una lista de tuplas " +"del tipo ``(article_number, overview)``, una para cada artículo seleccionado " +"por *message_spec*. Cada *overview* es un diccionario con el mismo número de " +"elementos, pero este número depende del servidor. Estos elementos son " +"encabezados de mensajes (la clave es entonces el nombre del encabezado en " +"minúsculas) o elementos de metadatos (la clave es entonces el nombre de los " +"metadatos precedido de ``\":\"``). Se garantiza la presencia de los " +"siguientes elementos por la especificación NNTP:" #: ../Doc/library/nntplib.rst:373 msgid "" "the ``subject``, ``from``, ``date``, ``message-id`` and ``references`` " "headers" msgstr "" +"los encabezados ``subject``, ``from``, ``date``, ``message-id`` y " +"``references``" #: ../Doc/library/nntplib.rst:375 msgid "" "the ``:bytes`` metadata: the number of bytes in the entire raw article " "(including headers and body)" msgstr "" +"los metadatos ``:bytes``: el número de bytes en todo el artículo sin " +"procesar (incluidos los encabezados y el cuerpo)" #: ../Doc/library/nntplib.rst:377 msgid "the ``:lines`` metadata: the number of lines in the article body" msgstr "" +"los metadatos ``:lines``: el número de líneas en el cuerpo del artículo" #: ../Doc/library/nntplib.rst:379 msgid "" "The value of each item is either a string, or :const:`None` if not present." msgstr "" +"El valor de cada elemento es una cadena o :const:`None` si no está presente." #: ../Doc/library/nntplib.rst:381 msgid "" "It is advisable to use the :func:`decode_header` function on header values " "when they may contain non-ASCII characters::" msgstr "" +"Es aconsejable utilizar la función :func:`decode_header` en los valores del " +"encabezado cuando pueden contener caracteres no-ASCII::" #: ../Doc/library/nntplib.rst:401 msgid "" "Send a ``HELP`` command. Return a pair ``(response, list)`` where *list* is " "a list of help strings." msgstr "" +"Envía un comando ``HELP``. Retorna un par ``(response, list)`` donde *list* " +"es una lista de cadenas de caracteres de ayuda." #: ../Doc/library/nntplib.rst:407 msgid "" @@ -429,14 +607,20 @@ msgid "" "current group is considered. Return a triple ``(response, number, id)`` " "where *number* is the article number and *id* is the message id." msgstr "" +"Envía un comando ``STAT``, donde *message_spec* es un identificador de " +"mensaje (incluido en ``'<'`` y ``'>'``) o un número de artículo en el grupo " +"actual. Si se omite *message_spec* o es :const:`None` se considera el " +"artículo actual del grupo actual. Retorna un triple ``(response, number, " +"id)`` donde *number* es el número de artículo e *id* es el identificador del " +"mensaje." #: ../Doc/library/nntplib.rst:421 msgid "Send a ``NEXT`` command. Return as for :meth:`.stat`." -msgstr "" +msgstr "Envía un comando ``NEXT``. Retorna como para :meth:`.stat`." #: ../Doc/library/nntplib.rst:426 msgid "Send a ``LAST`` command. Return as for :meth:`.stat`." -msgstr "" +msgstr "Envía un comando ``LAST``. Retorna como para :meth:`.stat`." #: ../Doc/library/nntplib.rst:431 msgid "" @@ -448,6 +632,14 @@ msgid "" "string, and *lines* a list of lines (without terminating newlines) " "comprising the raw message including headers and body." msgstr "" +"Envía un comando ``ARTICLE``, donde *message_spec* tiene el mismo " +"significado que para :meth:`.stat`. Retorna una tupla ``(response, info)`` " +"donde *info* es un :class:`~collections.namedtuple` con tres atributos " +"*number*, *message_id* y *lines* (en ese orden). *number* es el número de " +"artículo del grupo (o 0 si la información no está disponible), *message_id* " +"el identificador del mensaje como una cadena y *lines* una lista de líneas " +"(sin terminar líneas nuevas) que comprende el mensaje sin procesar, " +"incluidos los encabezados y el cuerpo." #: ../Doc/library/nntplib.rst:456 msgid "" @@ -455,6 +647,9 @@ msgid "" "returned (or written to *file*) will only contain the message headers, not " "the body." msgstr "" +"Igual que :meth:`article()`, pero envía un comando ``HEAD``. Las *lines* " +"retornadas (o escritas a *file*) solo contendrán los encabezados del " +"mensaje, no el cuerpo." #: ../Doc/library/nntplib.rst:463 msgid "" @@ -462,6 +657,9 @@ msgid "" "returned (or written to *file*) will only contain the message body, not the " "headers." msgstr "" +"Igual que :meth:`article()`, pero envía un comando ``BODY``. Las *lines* " +"retornadas (o escritas a *file*) solo contendrán los encabezados del " +"mensaje, no el cuerpo." #: ../Doc/library/nntplib.rst:470 msgid "" @@ -472,12 +670,21 @@ msgid "" "meth:`post` method automatically escapes lines beginning with ``.`` and " "appends the termination line." msgstr "" +"Publica un artículo utilizando el comando ``POST``. El argumento *data* es " +"un :term:`file object` abierto para la lectura binaria o cualquier iterable " +"de objetos bytes (que representa las líneas sin procesar del artículo que se " +"va a publicar). Debe representar un artículo de noticias bien formado, " +"incluidos los encabezados requeridos. El método :meth:`post` escapa " +"automáticamente las líneas que comienzan con ``.`` y añade la línea de " +"terminación." #: ../Doc/library/nntplib.rst:477 msgid "" "If the method succeeds, the server's response is returned. If the server " "refuses posting, a :class:`NNTPReplyError` is raised." msgstr "" +"Si el método tiene éxito, se retorna la respuesta del servidor. Si el " +"servidor se niega a publicarlo, se genera un :class:`NNTPReplyError`." #: ../Doc/library/nntplib.rst:483 msgid "" @@ -485,16 +692,21 @@ msgid "" "the server (enclosed in ``'<'`` and ``'>'``). The *data* parameter and the " "return value are the same as for :meth:`post()`." msgstr "" +"Envía un comando ``IHAVE``. *message_id* es el identificador del mensaje que " +"se enviará al servidor (incluido entre ``'<'`` y ``'>'``). El parámetro " +"*data* y el valor de retorno son los mismos que para :meth:`post()`." #: ../Doc/library/nntplib.rst:490 msgid "" "Return a pair ``(response, date)``. *date* is a :class:`~datetime.datetime` " "object containing the current date and time of the server." msgstr "" +"Devuelve un par ``(response, date)``. *date* es un objeto :class:`~datetime." +"datetime` que contiene la fecha y hora actuales del servidor." #: ../Doc/library/nntplib.rst:496 msgid "Send a ``SLAVE`` command. Return the server's *response*." -msgstr "" +msgstr "Envía un comando ``SLAVE``. Retorna la *response* del servidor." #: ../Doc/library/nntplib.rst:501 msgid "" @@ -505,12 +717,22 @@ msgid "" "maximum amount of debugging output, logging each line sent and received on " "the connection (including message text)." msgstr "" +"Establece el nivel de depuración de la instancia. Esto controla la cantidad " +"de salida de depuración impresa. El valor por defecto, ``0``, no produce " +"salida de depuración. Un valor de ``1`` produce una cantidad moderada de " +"salida de depuración, generalmente una sola línea por solicitud o por " +"respuesta. Un valor de ``2`` o superior produce la cantidad máxima de salida " +"de depuración, registrando cada línea enviada y recibida en la conexión " +"(incluyendo el texto del mensaje)." #: ../Doc/library/nntplib.rst:509 msgid "" "The following are optional NNTP extensions defined in :rfc:`2980`. Some of " "them have been superseded by newer commands in :rfc:`3977`." msgstr "" +"Las siguientes son extensiones NNTP opcionales definidas en :rfc:`2980`. " +"Algunas de ellas han sido reemplazados por comandos más nuevos en :rfc:" +"`3977`." #: ../Doc/library/nntplib.rst:515 msgid "" @@ -526,6 +748,18 @@ msgid "" "calling :meth:`write` on it to store the lines of the command output. If " "*file* is supplied, then the returned *list* is an empty list." msgstr "" +"Envía un comando ``XHDR``. El argumento *hdr* es una palabra clave de " +"encabezado, por ejemplo ``'subject'``. El argumento *str* debe tener la " +"forma ``'first-last'`` donde *first* y *last* son el primer y último número " +"de artículo para buscar. Retorna un par ``(response, list)``, donde *list* " +"es una lista de pares ``(id, text)``, donde *id* es un número de artículo " +"(como una cadena) y *text* es el texto del encabezado solicitado para ese " +"artículo. Si se proporciona el parámetro *file*, entonces la salida del " +"comando ``XHDR`` se almacena en un archivo. Si *file* es una cadena, " +"entonces el método abrirá un archivo con ese nombre, que escribirá en él y " +"luego lo cerrará. Si *file* es un :term:`file object`, entonces comenzará " +"invocando :meth:`write` en él para almacenar las líneas de la salida del " +"comando. Si se proporciona *file*, entonces retorna *list* o una lista vacía." #: ../Doc/library/nntplib.rst:530 msgid "" @@ -534,6 +768,11 @@ msgid "" "`over()`. It is recommended to use :meth:`over()` instead, since it will " "automatically use the newer ``OVER`` command if available." msgstr "" +"Envía un comando ``XOVER``. *start* and *end* son números de artículo que " +"delimitan el rango de artículos a seleccionar. El valor de retorno es el " +"mismo que para :meth:`over()`. Se recomienda usar :meth:`over()` en su " +"lugar, ya que se usará automáticamente el comando más nuevo ``OVER`` si está " +"disponible." #: ../Doc/library/nntplib.rst:539 msgid "" @@ -541,18 +780,21 @@ msgid "" "article with message ID *id*. Most of the time, this extension is not " "enabled by NNTP server administrators." msgstr "" +"Retorna un par ``(resp, path)``, donde *path* es la ruta del directorio al " +"artículo con un ID de mensaje *id*. La mayoría de las veces, los " +"administradores del servidor NNTP no habilitan esta extensión." #: ../Doc/library/nntplib.rst:543 msgid "The XPATH extension is not actively used." -msgstr "" +msgstr "La extensión XPATH no se utiliza activamente." #: ../Doc/library/nntplib.rst:565 msgid "Utility functions" -msgstr "" +msgstr "Funciones de utilidad" #: ../Doc/library/nntplib.rst:567 msgid "The module also defines the following utility function:" -msgstr "" +msgstr "El módulo también define la siguiente función de utilidad:" #: ../Doc/library/nntplib.rst:572 msgid "" @@ -561,3 +803,7 @@ msgid "" "returned. Using this function is recommended to display some headers in a " "human readable form::" msgstr "" +"Decodifica un valor de encabezado, eliminando los caracteres de escape que " +"no sean ASCII. *header_str* debe ser un objeto :class:`str`. Se retorna el " +"valor sin escape. Se recomienda utilizar esta función para mostrar algunos " +"encabezados en una forma legible por humanos::"