# 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 \n" "Language-Team: FRENCH \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 `: 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 ` ``nntplib.connect`` with " "arguments ``self``, ``host``, ``port``." msgstr "" #: library/nntplib.rst:131 msgid "" "Raises an :ref:`auditing event ` ``nntplib.putline`` with " "arguments ``self``, ``line``." msgstr "" #: library/nntplib.rst:124 msgid "" "All commands will raise an :ref:`auditing event ` ``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 ""