290 lines
9.4 KiB
Plaintext
290 lines
9.4 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2017-08-10 00:49+0200\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"
|
|
|
|
#: ../Doc/library/poplib.rst:2
|
|
msgid ":mod:`poplib` --- POP3 protocol client"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:10
|
|
msgid "**Source code:** :source:`Lib/poplib.py`"
|
|
msgstr "**Code source :** :source:`Lib/poplib.py`"
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:31
|
|
msgid "The :mod:`poplib` module provides two classes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:36
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:45
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:53
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:57
|
|
msgid "*context* parameter added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:60
|
|
msgid ""
|
|
"The class now supports hostname check with :attr:`ssl.SSLContext."
|
|
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:67
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:72
|
|
msgid "One exception is defined as an attribute of the :mod:`poplib` module:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:77
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:85
|
|
msgid "Module :mod:`imaplib`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:85
|
|
msgid "The standard Python IMAP module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:89
|
|
msgid ""
|
|
"`Frequently Asked Questions About Fetchmail <http://www.catb.org/~esr/"
|
|
"fetchmail/fetchmail-FAQ.html>`_"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:88
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:96
|
|
msgid "POP3 Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:98
|
|
msgid ""
|
|
"All POP3 commands are represented by methods of the same name, in lower-"
|
|
"case; most return the response text sent by the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:101
|
|
msgid "An :class:`POP3` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:106
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:115
|
|
msgid "Returns the greeting string sent by the POP3 server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:120
|
|
msgid ""
|
|
"Query the server's capabilities as specified in :rfc:`2449`. Returns a "
|
|
"dictionary in the form ``{'name': ['param'...]}``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:128
|
|
msgid ""
|
|
"Send user command, response should indicate that a password is required."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:133
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:139
|
|
msgid "Use the more secure APOP authentication to log into the POP3 server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:144
|
|
msgid ""
|
|
"Use RPOP authentication (similar to UNIX r-commands) to log into POP3 server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:149
|
|
msgid ""
|
|
"Get mailbox status. The result is a tuple of 2 integers: ``(message count, "
|
|
"mailbox size)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:155
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:161
|
|
msgid ""
|
|
"Retrieve whole message number *which*, and set its seen flag. Result is in "
|
|
"form ``(response, ['line', ...], octets)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:167
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:174
|
|
msgid "Remove any deletion marks for the mailbox."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:179
|
|
msgid "Do nothing. Might be used as a keep-alive."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:184
|
|
msgid "Signoff: commit changes, unlock mailbox, drop connection."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:189
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:193
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:201
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:208
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:216
|
|
msgid ""
|
|
"Start a TLS session on the active connection as specified in :rfc:`2595`. "
|
|
"This is only allowed before user authentication"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:219
|
|
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 ""
|
|
|
|
#: ../Doc/library/poplib.rst:224
|
|
msgid ""
|
|
"This method supports hostname checking via :attr:`ssl.SSLContext."
|
|
"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:231
|
|
msgid ""
|
|
"Instances of :class:`POP3_SSL` have no additional methods. The interface of "
|
|
"this subclass is identical to its parent."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:238
|
|
msgid "POP3 Example"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:240
|
|
msgid ""
|
|
"Here is a minimal example (without error checking) that opens a mailbox and "
|
|
"retrieves and prints all messages::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/poplib.rst:253
|
|
msgid ""
|
|
"At the end of the module, there is a test section that contains a more "
|
|
"extensive example of usage."
|
|
msgstr ""
|