python-docs-fr/library/nntplib.po

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#: library/nntplib.rst:2
msgid ":mod:`nntplib` --- NNTP protocol client"
msgstr ""

#: library/nntplib.rst:8
msgid "**Source code:** :source:`Lib/nntplib.py`"
msgstr "**Code source :** :source:`Lib/nntplib.py`"

#: library/nntplib.rst:14
msgid "The :mod:`nntplib` module is deprecated (see :pep:`594` for details)."
msgstr ""

#: library/nntplib.rst:19
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`."
msgstr ""

#: includes/wasm-notavail.rst:None
msgid ":ref:`Availability <availability>`: not Emscripten, not WASI."
msgstr ""

#: includes/wasm-notavail.rst:5
msgid ""
"This module does not work or is not available on WebAssembly platforms "
"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for "
"more information."
msgstr ""

#: library/nntplib.rst:26
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 ""

#: library/nntplib.rst:50
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 ""

#: library/nntplib.rst:60
msgid "The module itself defines the following classes:"
msgstr ""

#: library/nntplib.rst:65
msgid ""
"Return a new :class:`NNTP` object, representing a connection to the NNTP "
"server running on host *host*, listening at port *port*. An optional "
"*timeout* can be specified for the socket connection. If the optional *user* "
"and *password* are provided, or if suitable credentials are present in :file:"
"`/.netrc` and the optional flag *usenetrc* is true, the ``AUTHINFO USER`` "
"and ``AUTHINFO PASS`` commands are used to identify and authenticate the "
"user to the server.  If the optional flag *readermode* is true, then a "
"``mode reader`` command is sent before authentication is performed.  Reader "
"mode is sometimes necessary if you are connecting to an NNTP server on the "
"local machine and intend to call reader-specific commands, such as "
"``group``.  If you get unexpected :exc:`NNTPPermanentError`\\ s, you might "
"need to set *readermode*. The :class:`NNTP` class supports the :keyword:"
"`with` statement to unconditionally consume :exc:`OSError` exceptions and to "
"close the NNTP connection when done, e.g.:"
msgstr ""

#: library/nntplib.rst:129
msgid ""
"Raises an :ref:`auditing event <auditing>` ``nntplib.connect`` with "
"arguments ``self``, ``host``, ``port``."
msgstr ""

#: library/nntplib.rst:131
msgid ""
"Raises an :ref:`auditing event <auditing>` ``nntplib.putline`` with "
"arguments ``self``, ``line``."
msgstr ""

#: library/nntplib.rst:124
msgid ""
"All commands will raise an :ref:`auditing event <auditing>` ``nntplib."
"putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes "
"about to be sent to the remote host."
msgstr ""

#: library/nntplib.rst:96
msgid "*usenetrc* is now ``False`` by default."
msgstr ""

#: library/nntplib.rst:99
msgid "Support for the :keyword:`with` statement was added."
msgstr "La prise en charge de l'instruction :keyword:`with` a été ajoutée."

#: library/nntplib.rst:135
msgid ""
"If the *timeout* parameter is set to be zero, it will raise a :class:"
"`ValueError` to prevent the creation of a non-blocking socket."
msgstr ""

#: library/nntplib.rst:108
msgid ""
"Return a new :class:`NNTP_SSL` object, representing an encrypted connection "
"to the NNTP server running on host *host*, listening at port *port*.  :class:"
"`NNTP_SSL` objects have the same methods as :class:`NNTP` objects.  If "
"*port* is omitted, port 563 (NNTPS) is used. *ssl_context* is also optional, "
"and is a :class:`~ssl.SSLContext` object. Please read :ref:`ssl-security` "
"for best practices. All other parameters behave the same as for :class:"
"`NNTP`."
msgstr ""

#: library/nntplib.rst:116
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 ""

#: library/nntplib.rst:130
msgid ""
"The class now supports hostname check with :attr:`ssl.SSLContext."
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
msgstr ""

#: library/nntplib.rst:141
msgid ""
"Derived from the standard exception :exc:`Exception`, this is the base class "
"for all exceptions raised by the :mod:`nntplib` module.  Instances of this "
"class have the following attribute:"
msgstr ""

#: library/nntplib.rst:147
msgid "The response of the server if available, as a :class:`str` object."
msgstr ""

#: library/nntplib.rst:152
msgid "Exception raised when an unexpected reply is received from the server."
msgstr ""

#: library/nntplib.rst:157
msgid ""
"Exception raised when a response code in the range 400--499 is received."
msgstr ""

#: library/nntplib.rst:162
msgid ""
"Exception raised when a response code in the range 500--599 is received."
msgstr ""

#: library/nntplib.rst:167
msgid ""
"Exception raised when a reply is received from the server that does not "
"begin with a digit in the range 1--5."
msgstr ""

#: library/nntplib.rst:173
msgid "Exception raised when there is some error in the response data."
msgstr ""

#: library/nntplib.rst:179
msgid "NNTP Objects"
msgstr ""

#: library/nntplib.rst:181
msgid ""
"When connected, :class:`NNTP` and :class:`NNTP_SSL` objects support the "
"following methods and attributes."
msgstr ""

#: library/nntplib.rst:185
#, fuzzy
msgid "Attributes"
msgstr "Attributs :"

#: library/nntplib.rst:189
msgid ""
"An integer representing the version of the NNTP protocol supported by the "
"server.  In practice, this should be ``2`` for servers advertising :rfc:"
"`3977` compliance and ``1`` for others."
msgstr ""

#: library/nntplib.rst:197
msgid ""
"A string describing the software name and version of the NNTP server, or :"
"const:`None` if not advertised by the server."
msgstr ""

#: library/nntplib.rst:203
msgid "Methods"
msgstr "Méthodes"

#: library/nntplib.rst:205
msgid ""
"The *response* that is returned as the first item in the return tuple of "
"almost all methods is the server's response: a string beginning with a three-"
"digit code.  If the server's response indicates an error, the method raises "
"one of the above exceptions."
msgstr ""

#: library/nntplib.rst:210
msgid ""
"Many of the following methods take an optional keyword-only argument *file*. "
"When the *file* argument is supplied, it must be either a :term:`file "
"object` opened for binary writing, or the name of an on-disk file to be "
"written to. The method will then write any data returned by the server "
"(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 ""

#: library/nntplib.rst:217
msgid ""
"Many of the following methods have been reworked and fixed, which makes them "
"incompatible with their 3.1 counterparts."
msgstr ""

#: library/nntplib.rst:224
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 ""

#: library/nntplib.rst:230
msgid ""
"Return the welcome message sent by the server in reply to the initial "
"connection.  (This message sometimes contains disclaimers or help "
"information that may be relevant to the user.)"
msgstr ""

#: library/nntplib.rst:237
msgid ""
"Return the :rfc:`3977` capabilities advertised by the server, as a :class:"
"`dict` instance mapping capability names to (possibly empty) lists of "
"values. On legacy servers which don't understand the ``CAPABILITIES`` "
"command, an empty dictionary is returned instead."
msgstr ""

#: library/nntplib.rst:251
msgid ""
"Send ``AUTHINFO`` commands with the user name and password.  If *user* and "
"*password* are ``None`` and *usenetrc* is true, credentials from ``~/."
"netrc`` will be used if possible."
msgstr ""

#: library/nntplib.rst:255
msgid ""
"Unless intentionally delayed, login is normally performed during the :class:"
"`NNTP` object initialization and separately calling this function is "
"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 ""

#: library/nntplib.rst:266
msgid ""
"Send a ``STARTTLS`` command.  This will enable encryption on the NNTP "
"connection.  The *context* argument is optional and should be a :class:`ssl."
"SSLContext` object.  Please read :ref:`ssl-security` for best practices."
msgstr ""

#: library/nntplib.rst:271
msgid ""
"Note that this may not be done after authentication information has been "
"transmitted, and authentication occurs by default if possible during a :"
"class:`NNTP` object initialization.  See :meth:`NNTP.login` for information "
"on suppressing this behavior."
msgstr ""

#: library/nntplib.rst:278
msgid ""
"The method now supports hostname check with :attr:`ssl.SSLContext."
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
msgstr ""

#: library/nntplib.rst:285
msgid ""
"Send a ``NEWGROUPS`` command.  The *date* argument should be a :class:"
"`datetime.date` or :class:`datetime.datetime` object. Return a pair "
"``(response, groups)`` where *groups* is a list representing the groups that "
"are new since the given *date*. If *file* is supplied, though, then *groups* "
"will be empty."
msgstr ""

#: library/nntplib.rst:301
msgid ""
"Send a ``NEWNEWS`` command.  Here, *group* is a group name or ``'*'``, and "
"*date* has the same meaning as for :meth:`newgroups`.  Return a pair "
"``(response, articles)`` where *articles* is a list of message ids."
msgstr ""

#: library/nntplib.rst:305
msgid "This command is frequently disabled by NNTP server administrators."
msgstr ""

#: library/nntplib.rst:310
msgid ""
"Send a ``LIST`` or ``LIST ACTIVE`` command.  Return a pair ``(response, "
"list)`` where *list* is a list of tuples representing all the groups "
"available from this NNTP server, optionally matching the pattern string "
"*group_pattern*.  Each tuple has the form ``(group, last, first, flag)``, "
"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 ""

#: library/nntplib.rst:318
msgid "``y``: Local postings and articles from peers are allowed."
msgstr ""

#: library/nntplib.rst:319
msgid "``m``: The group is moderated and all postings must be approved."
msgstr ""

#: library/nntplib.rst:320
msgid "``n``: No local postings are allowed, only articles from peers."
msgstr ""

#: library/nntplib.rst:321
msgid "``j``: Articles from peers are filed in the junk group instead."
msgstr ""

#: library/nntplib.rst:322
msgid "``x``: No local postings, and articles from peers are ignored."
msgstr ""

#: library/nntplib.rst:323
msgid "``=foo.bar``: Articles are filed in the ``foo.bar`` group instead."
msgstr ""

#: library/nntplib.rst:325
msgid ""
"If *flag* has another value, then the status of the newsgroup should be "
"considered unknown."
msgstr ""

#: library/nntplib.rst:328
msgid ""
"This command can return very large results, especially if *group_pattern* is "
"not specified.  It is best to cache the results offline unless you really "
"need to refresh them."
msgstr ""

#: library/nntplib.rst:332
msgid "*group_pattern* was added."
msgstr ""

#: library/nntplib.rst:338
msgid ""
"Send a ``LIST NEWSGROUPS`` command, where *grouppattern* is a wildmat string "
"as specified in :rfc:`3977` (it's essentially the same as DOS or UNIX shell "
"wildcard strings).  Return a pair ``(response, descriptions)``, where "
"*descriptions* is a dictionary mapping group names to textual descriptions."
msgstr ""

#: library/nntplib.rst:352
msgid ""
"Get a description for a single group *group*.  If more than one group "
"matches (if 'group' is a real wildmat string), return the first match.   If "
"no group matches, return an empty string."
msgstr ""

#: library/nntplib.rst:356
msgid ""
"This elides the response code from the server.  If the response code is "
"needed, use :meth:`descriptions`."
msgstr ""

#: library/nntplib.rst:362
msgid ""
"Send a ``GROUP`` command, where *name* is the group name.  The group is "
"selected as the current group, if it exists.  Return a tuple ``(response, "
"count, first, last, name)`` where *count* is the (estimated) number of "
"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 ""

#: library/nntplib.rst:372
msgid ""
"Send an ``OVER`` command, or an ``XOVER`` command on legacy servers. "
"*message_spec* can be either a string representing a message id, or a "
"``(first, last)`` tuple of numbers indicating a range of articles in the "
"current group, or a ``(first, None)`` tuple indicating a range of articles "
"starting from *first* to the last article in the current group, or :const:"
"`None` to select the current article in the current group."
msgstr ""

#: library/nntplib.rst:379
msgid ""
"Return a pair ``(response, overviews)``.  *overviews* is a list of "
"``(article_number, overview)`` tuples, one for each article selected by "
"*message_spec*.  Each *overview* is a dictionary with the same number of "
"items, but this number depends on the server.  These items are either "
"message headers (the key is then the lower-cased header name) or metadata "
"items (the key is then the metadata name prepended with ``\":\"``).  The "
"following items are guaranteed to be present by the NNTP specification:"
msgstr ""

#: library/nntplib.rst:387
msgid ""
"the ``subject``, ``from``, ``date``, ``message-id`` and ``references`` "
"headers"
msgstr ""

#: library/nntplib.rst:389
msgid ""
"the ``:bytes`` metadata: the number of bytes in the entire raw article "
"(including headers and body)"
msgstr ""

#: library/nntplib.rst:391
msgid "the ``:lines`` metadata: the number of lines in the article body"
msgstr ""

#: library/nntplib.rst:393
msgid ""
"The value of each item is either a string, or :const:`None` if not present."
msgstr ""

#: library/nntplib.rst:395
msgid ""
"It is advisable to use the :func:`decode_header` function on header values "
"when they may contain non-ASCII characters::"
msgstr ""

#: library/nntplib.rst:415
msgid ""
"Send a ``HELP`` command.  Return a pair ``(response, list)`` where *list* is "
"a list of help strings."
msgstr ""

#: library/nntplib.rst:421
msgid ""
"Send a ``STAT`` command, where *message_spec* is either a message id "
"(enclosed in ``'<'`` and ``'>'``) or an article number in the current group. "
"If *message_spec* is omitted or :const:`None`, the current article in the "
"current group is considered.  Return a triple ``(response, number, id)`` "
"where *number* is the article number and *id* is the message id."
msgstr ""

#: library/nntplib.rst:435
msgid "Send a ``NEXT`` command.  Return as for :meth:`.stat`."
msgstr ""

#: library/nntplib.rst:440
msgid "Send a ``LAST`` command.  Return as for :meth:`.stat`."
msgstr ""

#: library/nntplib.rst:445
msgid ""
"Send an ``ARTICLE`` command, where *message_spec* has the same meaning as "
"for :meth:`.stat`.  Return a tuple ``(response, info)`` where *info* is a :"
"class:`~collections.namedtuple` with three attributes *number*, *message_id* "
"and *lines* (in that order).  *number* is the article number in the group "
"(or 0 if the information is not available), *message_id* the message id as a "
"string, and *lines* a list of lines (without terminating newlines) "
"comprising the raw message including headers and body."
msgstr ""

#: library/nntplib.rst:470
msgid ""
"Same as :meth:`article()`, but sends a ``HEAD`` command.  The *lines* "
"returned (or written to *file*) will only contain the message headers, not "
"the body."
msgstr ""

#: library/nntplib.rst:477
msgid ""
"Same as :meth:`article()`, but sends a ``BODY`` command.  The *lines* "
"returned (or written to *file*) will only contain the message body, not the "
"headers."
msgstr ""

#: library/nntplib.rst:484
msgid ""
"Post an article using the ``POST`` command.  The *data* argument is either "
"a :term:`file object` opened for binary reading, or any iterable of bytes "
"objects (representing raw lines of the article to be posted).  It should "
"represent a well-formed news article, including the required headers.  The :"
"meth:`post` method automatically escapes lines beginning with ``.`` and "
"appends the termination line."
msgstr ""

#: library/nntplib.rst:491
msgid ""
"If the method succeeds, the server's response is returned.  If the server "
"refuses posting, a :class:`NNTPReplyError` is raised."
msgstr ""

#: library/nntplib.rst:497
msgid ""
"Send an ``IHAVE`` command. *message_id* is the id of the message to send to "
"the server (enclosed in  ``'<'`` and ``'>'``).  The *data* parameter and the "
"return value are the same as for :meth:`post()`."
msgstr ""

#: library/nntplib.rst:504
msgid ""
"Return a pair ``(response, date)``.  *date* is a :class:`~datetime.datetime` "
"object containing the current date and time of the server."
msgstr ""

#: library/nntplib.rst:510
msgid "Send a ``SLAVE`` command.  Return the server's *response*."
msgstr ""

#: library/nntplib.rst:515
msgid ""
"Set the instance's debugging level.  This controls the amount of debugging "
"output printed.  The default, ``0``, produces no debugging output.  A value "
"of ``1`` produces a moderate amount of debugging output, generally a single "
"line per request or response.  A value of ``2`` or higher produces the "
"maximum amount of debugging output, logging each line sent and received on "
"the connection (including message text)."
msgstr ""

#: library/nntplib.rst:523
msgid ""
"The following are optional NNTP extensions defined in :rfc:`2980`.  Some of "
"them have been superseded by newer commands in :rfc:`3977`."
msgstr ""

#: library/nntplib.rst:529
msgid ""
"Send an ``XHDR`` command.  The *hdr* argument is a header keyword, e.g. "
"``'subject'``.  The *str* argument should have the form ``'first-last'`` "
"where *first* and *last* are the first and last article numbers to search. "
"Return a pair ``(response, list)``, where *list* is a list of pairs ``(id, "
"text)``, where *id* is an article number (as a string) and *text* is the "
"text of the requested header for that article. If the *file* parameter is "
"supplied, then the output of the  ``XHDR`` command is stored in a file.  If "
"*file* is a string, then the method will open a file with that name, write "
"to it  then close it. If *file* is a :term:`file object`, then it will start "
"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 ""

#: library/nntplib.rst:544
msgid ""
"Send an ``XOVER`` command.  *start* and *end* are article numbers delimiting "
"the range of articles to select.  The return value is the same of for :meth:"
"`over()`.  It is recommended to use :meth:`over()` instead, since it will "
"automatically use the newer ``OVER`` command if available."
msgstr ""

#: library/nntplib.rst:552
msgid "Utility functions"
msgstr "Fonctions utilitaires"

#: library/nntplib.rst:554
msgid "The module also defines the following utility function:"
msgstr ""

#: library/nntplib.rst:559
msgid ""
"Decode a header value, un-escaping any escaped non-ASCII characters. "
"*header_str* must be a :class:`str` object.  The unescaped value is "
"returned.  Using this function is recommended to display some headers in a "
"human readable form::"
msgstr ""