forked from AFPy/python-docs-fr
326 lines
10 KiB
Plaintext
326 lines
10 KiB
Plaintext
# 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/poplib.rst:2
|
|
msgid ":mod:`poplib` --- POP3 protocol client"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:10
|
|
msgid "**Source code:** :source:`Lib/poplib.py`"
|
|
msgstr "**Code source :** :source:`Lib/poplib.py`"
|
|
|
|
#: library/poplib.rst:16
|
|
msgid ""
|
|
"This module defines a class, :class:`POP3`, which encapsulates a connection "
|
|
"to a POP3 server and implements the protocol as defined in :rfc:`1939`. The :"
|
|
"class:`POP3` class supports both the minimal and optional command sets from :"
|
|
"rfc:`1939`. The :class:`POP3` class also supports the ``STLS`` command "
|
|
"introduced in :rfc:`2595` to enable encrypted communication on an already "
|
|
"established connection."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:22
|
|
msgid ""
|
|
"Additionally, this module provides a class :class:`POP3_SSL`, which provides "
|
|
"support for connecting to POP3 servers that use SSL as an underlying "
|
|
"protocol layer."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:26
|
|
msgid ""
|
|
"Note that POP3, though widely supported, is obsolescent. The implementation "
|
|
"quality of POP3 servers varies widely, and too many are quite poor. If your "
|
|
"mailserver supports IMAP, you would be better off using the :class:`imaplib."
|
|
"IMAP4` class, as IMAP servers tend to be better implemented."
|
|
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/poplib.rst:33
|
|
msgid "The :mod:`poplib` module provides two classes:"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:38
|
|
msgid ""
|
|
"This class implements the actual POP3 protocol. The connection is created "
|
|
"when the instance is initialized. If *port* is omitted, the standard POP3 "
|
|
"port (110) is used. The optional *timeout* parameter specifies a timeout in "
|
|
"seconds for the connection attempt (if not specified, the global default "
|
|
"timeout setting will be used)."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:79
|
|
msgid ""
|
|
"Raises an :ref:`auditing event <auditing>` ``poplib.connect`` with arguments "
|
|
"``self``, ``host``, ``port``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:81
|
|
msgid ""
|
|
"Raises an :ref:`auditing event <auditing>` ``poplib.putline`` with arguments "
|
|
"``self``, ``line``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:74
|
|
msgid ""
|
|
"All commands will raise an :ref:`auditing event <auditing>` ``poplib."
|
|
"putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes "
|
|
"about to be sent to the remote host."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:93
|
|
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/poplib.rst:58
|
|
msgid ""
|
|
"This is a subclass of :class:`POP3` that connects to the server over an SSL "
|
|
"encrypted socket. If *port* is not specified, 995, the standard POP3-over-"
|
|
"SSL port is used. *timeout* works as in the :class:`POP3` constructor. "
|
|
"*context* is an optional :class:`ssl.SSLContext` object which allows "
|
|
"bundling SSL configuration options, certificates and private keys into a "
|
|
"single (potentially long-lived) structure. Please read :ref:`ssl-security` "
|
|
"for best practices."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:66
|
|
msgid ""
|
|
"*keyfile* and *certfile* are a legacy alternative to *context* - they can "
|
|
"point to PEM-formatted private key and certificate chain files, "
|
|
"respectively, for the SSL connection."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:78
|
|
msgid "*context* parameter added."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:81
|
|
msgid ""
|
|
"The class now supports hostname check with :attr:`ssl.SSLContext."
|
|
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:88
|
|
msgid ""
|
|
"*keyfile* and *certfile* are deprecated in favor of *context*. Please use :"
|
|
"meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl."
|
|
"create_default_context` select the system's trusted CA certificates for you."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:97
|
|
msgid "One exception is defined as an attribute of the :mod:`poplib` module:"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:102
|
|
msgid ""
|
|
"Exception raised on any errors from this module (errors from :mod:`socket` "
|
|
"module are not caught). The reason for the exception is passed to the "
|
|
"constructor as a string."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:110
|
|
msgid "Module :mod:`imaplib`"
|
|
msgstr "Module :mod:`imaplib`"
|
|
|
|
#: library/poplib.rst:110
|
|
msgid "The standard Python IMAP module."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:114
|
|
msgid ""
|
|
"`Frequently Asked Questions About Fetchmail <http://www.catb.org/~esr/"
|
|
"fetchmail/fetchmail-FAQ.html>`_"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:113
|
|
msgid ""
|
|
"The FAQ for the :program:`fetchmail` POP/IMAP client collects information on "
|
|
"POP3 server variations and RFC noncompliance that may be useful if you need "
|
|
"to write an application based on the POP protocol."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:121
|
|
msgid "POP3 Objects"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:123
|
|
msgid ""
|
|
"All POP3 commands are represented by methods of the same name, in lowercase; "
|
|
"most return the response text sent by the server."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:126
|
|
msgid "A :class:`POP3` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:131
|
|
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. A value of ``2`` or higher produces the maximum amount of "
|
|
"debugging output, logging each line sent and received on the control "
|
|
"connection."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:140
|
|
msgid "Returns the greeting string sent by the POP3 server."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:145
|
|
msgid ""
|
|
"Query the server's capabilities as specified in :rfc:`2449`. Returns a "
|
|
"dictionary in the form ``{'name': ['param'...]}``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:153
|
|
msgid ""
|
|
"Send user command, response should indicate that a password is required."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:158
|
|
msgid ""
|
|
"Send password, response includes message count and mailbox size. Note: the "
|
|
"mailbox on the server is locked until :meth:`~poplib.quit` is called."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:164
|
|
msgid "Use the more secure APOP authentication to log into the POP3 server."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:169
|
|
msgid ""
|
|
"Use RPOP authentication (similar to UNIX r-commands) to log into POP3 server."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:174
|
|
msgid ""
|
|
"Get mailbox status. The result is a tuple of 2 integers: ``(message count, "
|
|
"mailbox size)``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:180
|
|
msgid ""
|
|
"Request message list, result is in the form ``(response, ['mesg_num "
|
|
"octets', ...], octets)``. If *which* is set, it is the message to list."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:186
|
|
msgid ""
|
|
"Retrieve whole message number *which*, and set its seen flag. Result is in "
|
|
"form ``(response, ['line', ...], octets)``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:192
|
|
msgid ""
|
|
"Flag message number *which* for deletion. On most servers deletions are not "
|
|
"actually performed until QUIT (the major exception is Eudora QPOP, which "
|
|
"deliberately violates the RFCs by doing pending deletes on any disconnect)."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:199
|
|
msgid "Remove any deletion marks for the mailbox."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:204
|
|
msgid "Do nothing. Might be used as a keep-alive."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:209
|
|
msgid "Signoff: commit changes, unlock mailbox, drop connection."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:214
|
|
msgid ""
|
|
"Retrieves the message header plus *howmuch* lines of the message after the "
|
|
"header of message number *which*. Result is in form ``(response, "
|
|
"['line', ...], octets)``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:218
|
|
msgid ""
|
|
"The POP3 TOP command this method uses, unlike the RETR command, doesn't set "
|
|
"the message's seen flag; unfortunately, TOP is poorly specified in the RFCs "
|
|
"and is frequently broken in off-brand servers. Test this method by hand "
|
|
"against the POP3 servers you will use before trusting it."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:226
|
|
msgid ""
|
|
"Return message digest (unique id) list. If *which* is specified, result "
|
|
"contains the unique id for that message in the form ``'response mesgnum "
|
|
"uid``, otherwise result is list ``(response, ['mesgnum uid', ...], octets)``."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:233
|
|
msgid ""
|
|
"Try to switch to UTF-8 mode. Returns the server response if successful, "
|
|
"raises :class:`error_proto` if not. Specified in :RFC:`6856`."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:241
|
|
msgid ""
|
|
"Start a TLS session on the active connection as specified in :rfc:`2595`. "
|
|
"This is only allowed before user authentication"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:244
|
|
msgid ""
|
|
"*context* parameter is a :class:`ssl.SSLContext` object which allows "
|
|
"bundling SSL configuration options, certificates and private keys into a "
|
|
"single (potentially long-lived) structure. Please read :ref:`ssl-security` "
|
|
"for best practices."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:249
|
|
msgid ""
|
|
"This method supports hostname checking via :attr:`ssl.SSLContext."
|
|
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:256
|
|
msgid ""
|
|
"Instances of :class:`POP3_SSL` have no additional methods. The interface of "
|
|
"this subclass is identical to its parent."
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:263
|
|
msgid "POP3 Example"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:265
|
|
msgid ""
|
|
"Here is a minimal example (without error checking) that opens a mailbox and "
|
|
"retrieves and prints all messages::"
|
|
msgstr ""
|
|
|
|
#: library/poplib.rst:278
|
|
msgid ""
|
|
"At the end of the module, there is a test section that contains a more "
|
|
"extensive example of usage."
|
|
msgstr ""
|