python-docs-fr/library/imaplib.po

# 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: 2018-06-10 11:27+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/imaplib.rst:2
msgid ":mod:`imaplib` --- IMAP4 protocol client"
msgstr ""

#: ../Doc/library/imaplib.rst:14
msgid "**Source code:** :source:`Lib/imaplib.py`"
msgstr "**Code source :** :source:`Lib/imaplib.py`"

#: ../Doc/library/imaplib.rst:23
msgid ""
"This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :"
"class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and "
"implement a large subset of the IMAP4rev1 client protocol as defined in :rfc:"
"`2060`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note "
"that the ``STATUS`` command is not supported in IMAP4."
msgstr ""

#: ../Doc/library/imaplib.rst:29
msgid ""
"Three classes are provided by the :mod:`imaplib` module, :class:`IMAP4` is "
"the base class:"
msgstr ""

#: ../Doc/library/imaplib.rst:35
msgid ""
"This class implements the actual IMAP4 protocol.  The connection is created "
"and protocol version (IMAP4 or IMAP4rev1) is determined when the instance is "
"initialized. If *host* is not specified, ``''`` (the local host) is used. If "
"*port* is omitted, the standard IMAP4 port (143) is used."
msgstr ""

#: ../Doc/library/imaplib.rst:40
msgid ""
"The :class:`IMAP4` class supports the :keyword:`with` statement.  When used "
"like this, the IMAP4 ``LOGOUT`` command is issued automatically when the :"
"keyword:`with` statement exits.  E.g.::"
msgstr ""

#: ../Doc/library/imaplib.rst:50
msgid "Support for the :keyword:`with` statement was added."
msgstr ""

#: ../Doc/library/imaplib.rst:53
msgid "Three exceptions are defined as attributes of the :class:`IMAP4` class:"
msgstr ""

#: ../Doc/library/imaplib.rst:58
msgid ""
"Exception raised on any errors.  The reason for the exception is passed to "
"the constructor as a string."
msgstr ""

#: ../Doc/library/imaplib.rst:64
msgid ""
"IMAP4 server errors cause this exception to be raised.  This is a sub-class "
"of :exc:`IMAP4.error`.  Note that closing the instance and instantiating a "
"new one will usually allow recovery from this exception."
msgstr ""

#: ../Doc/library/imaplib.rst:71
msgid ""
"This exception is raised when a writable mailbox has its status changed by "
"the server.  This is a sub-class of :exc:`IMAP4.error`.  Some other client "
"now has write permission, and the mailbox will need to be re-opened to re-"
"obtain write permission."
msgstr ""

#: ../Doc/library/imaplib.rst:77
msgid "There's also a subclass for secure connections:"
msgstr ""

#: ../Doc/library/imaplib.rst:83
msgid ""
"This is a subclass derived from :class:`IMAP4` that connects over an SSL "
"encrypted socket (to use this class you need a socket module that was "
"compiled with SSL support).  If *host* is not specified, ``''`` (the local "
"host) is used. If *port* is omitted, the standard IMAP4-over-SSL port (993) "
"is used. *ssl_context* 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/imaplib.rst:92
msgid ""
"*keyfile* and *certfile* are a legacy alternative to *ssl_context* - they "
"can point to PEM-formatted private key and certificate chain files for the "
"SSL connection.  Note that the *keyfile*/*certfile* parameters are mutually "
"exclusive with *ssl_context*, a :class:`ValueError` is raised if *keyfile*/"
"*certfile* is provided along with *ssl_context*."
msgstr ""

#: ../Doc/library/imaplib.rst:98
msgid "*ssl_context* parameter added."
msgstr ""

#: ../Doc/library/imaplib.rst:101
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/imaplib.rst:108
msgid ""
"*keyfile* and *certfile* are deprecated in favor of *ssl_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/imaplib.rst:114
msgid "The second subclass allows for connections created by a child process:"
msgstr ""

#: ../Doc/library/imaplib.rst:119
msgid ""
"This is a subclass derived from :class:`IMAP4` that connects to the ``stdin/"
"stdout`` file descriptors created by passing *command* to ``subprocess."
"Popen()``."
msgstr ""

#: ../Doc/library/imaplib.rst:124
msgid "The following utility functions are defined:"
msgstr ""

#: ../Doc/library/imaplib.rst:129
msgid ""
"Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local time.  "
"The return value is a :class:`time.struct_time` tuple or ``None`` if the "
"string has wrong format."
msgstr ""

#: ../Doc/library/imaplib.rst:135
msgid ""
"Converts an integer into a string representation using characters from the "
"set [``A`` .. ``P``]."
msgstr ""

#: ../Doc/library/imaplib.rst:141
msgid "Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags."
msgstr ""

#: ../Doc/library/imaplib.rst:146
msgid ""
"Convert *date_time* to an IMAP4 ``INTERNALDATE`` representation. The return "
"value is a string in the form: ``\"DD-Mmm-YYYY HH:MM:SS +HHMM\"`` (including "
"double-quotes).  The *date_time* argument can be a number (int or float) "
"representing seconds since epoch (as returned by :func:`time.time`), a 9-"
"tuple representing local time an instance of :class:`time.struct_time` (as "
"returned by :func:`time.localtime`), an aware instance of :class:`datetime."
"datetime`, or a double-quoted string.  In the last case, it is assumed to "
"already be in the correct format."
msgstr ""

#: ../Doc/library/imaplib.rst:156
msgid ""
"Note that IMAP4 message numbers change as the mailbox changes; in "
"particular, after an ``EXPUNGE`` command performs deletions the remaining "
"messages are renumbered. So it is highly advisable to use UIDs instead, with "
"the UID command."
msgstr ""

#: ../Doc/library/imaplib.rst:160
msgid ""
"At the end of the module, there is a test section that contains a more "
"extensive example of usage."
msgstr ""

#: ../Doc/library/imaplib.rst:166
msgid ""
"Documents describing the protocol, and sources and binaries  for servers "
"implementing it, can all be found at the University of Washington's *IMAP "
"Information Center* (https://www.washington.edu/imap/)."
msgstr ""

#: ../Doc/library/imaplib.rst:174
msgid "IMAP4 Objects"
msgstr ""

#: ../Doc/library/imaplib.rst:176
msgid ""
"All IMAP4rev1 commands are represented by methods of the same name, either "
"upper-case or lower-case."
msgstr ""

#: ../Doc/library/imaplib.rst:179
msgid ""
"All arguments to commands are converted to strings, except for "
"``AUTHENTICATE``, and the last argument to ``APPEND`` which is passed as an "
"IMAP4 literal.  If necessary (the string contains IMAP4 protocol-sensitive "
"characters and isn't enclosed with either parentheses or double quotes) each "
"string is quoted. However, the *password* argument to the ``LOGIN`` command "
"is always quoted. If you want to avoid having an argument string quoted (eg: "
"the *flags* argument to ``STORE``) then enclose the string in parentheses "
"(eg: ``r'(\\Deleted)'``)."
msgstr ""

#: ../Doc/library/imaplib.rst:187
msgid ""
"Each command returns a tuple: ``(type, [data, ...])`` where *type* is "
"usually ``'OK'`` or ``'NO'``, and *data* is either the text from the command "
"response, or mandated results from the command. Each *data* is either a "
"string, or a tuple. If a tuple, then the first part is the header of the "
"response, and the second part contains the data (ie: 'literal' value)."
msgstr ""

#: ../Doc/library/imaplib.rst:193
msgid ""
"The *message_set* options to commands below is a string specifying one or "
"more messages to be acted upon.  It may be a simple message number "
"(``'1'``), a range of message numbers (``'2:4'``), or a group of non-"
"contiguous ranges separated by commas (``'1:3,6:9'``).  A range can contain "
"an asterisk to indicate an infinite upper bound (``'3:*'``)."
msgstr ""

#: ../Doc/library/imaplib.rst:199
msgid "An :class:`IMAP4` instance has the following methods:"
msgstr ""

#: ../Doc/library/imaplib.rst:204
msgid "Append *message* to named mailbox."
msgstr ""

#: ../Doc/library/imaplib.rst:209
msgid "Authenticate command --- requires response processing."
msgstr ""

#: ../Doc/library/imaplib.rst:211
msgid ""
"*mechanism* specifies which authentication mechanism is to be used - it "
"should appear in the instance variable ``capabilities`` in the form "
"``AUTH=mechanism``."
msgstr ""

#: ../Doc/library/imaplib.rst:214
msgid "*authobject* must be a callable object::"
msgstr ""

#: ../Doc/library/imaplib.rst:218
msgid ""
"It will be called to process server continuation responses; the *response* "
"argument it is passed will be ``bytes``.  It should return ``bytes`` *data* "
"that will be base64 encoded and sent to the server.  It should return "
"``None`` if the client abort response ``*`` should be sent instead."
msgstr ""

#: ../Doc/library/imaplib.rst:223
msgid ""
"string usernames and passwords are now encoded to ``utf-8`` instead of being "
"limited to ASCII."
msgstr ""

#: ../Doc/library/imaplib.rst:230
msgid "Checkpoint mailbox on server."
msgstr ""

#: ../Doc/library/imaplib.rst:235
msgid ""
"Close currently selected mailbox. Deleted messages are removed from writable "
"mailbox. This is the recommended command before ``LOGOUT``."
msgstr ""

#: ../Doc/library/imaplib.rst:241
msgid "Copy *message_set* messages onto end of *new_mailbox*."
msgstr ""

#: ../Doc/library/imaplib.rst:246
msgid "Create new mailbox named *mailbox*."
msgstr ""

#: ../Doc/library/imaplib.rst:251
msgid "Delete old mailbox named *mailbox*."
msgstr ""

#: ../Doc/library/imaplib.rst:256
msgid "Delete the ACLs (remove any rights) set for who on mailbox."
msgstr ""

#: ../Doc/library/imaplib.rst:261
msgid ""
"Enable *capability* (see :rfc:`5161`).  Most capabilities do not need to be "
"enabled.  Currently only the ``UTF8=ACCEPT`` capability is supported (see :"
"RFC:`6855`)."
msgstr ""

#: ../Doc/library/imaplib.rst:265
msgid "The :meth:`enable` method itself, and :RFC:`6855` support."
msgstr ""

#: ../Doc/library/imaplib.rst:271
msgid ""
"Permanently remove deleted items from selected mailbox. Generates an "
"``EXPUNGE`` response for each deleted message. Returned data contains a list "
"of ``EXPUNGE`` message numbers in order received."
msgstr ""

#: ../Doc/library/imaplib.rst:278
msgid ""
"Fetch (parts of) messages.  *message_parts* should be a string of message "
"part names enclosed within parentheses, eg: ``\"(UID BODY[TEXT])\"``.  "
"Returned data are tuples of message part envelope and data."
msgstr ""

#: ../Doc/library/imaplib.rst:285
msgid ""
"Get the ``ACL``\\ s for *mailbox*. The method is non-standard, but is "
"supported by the ``Cyrus`` server."
msgstr ""

#: ../Doc/library/imaplib.rst:291
msgid ""
"Retrieve the specified ``ANNOTATION``\\ s for *mailbox*. The method is non-"
"standard, but is supported by the ``Cyrus`` server."
msgstr ""

#: ../Doc/library/imaplib.rst:297
msgid ""
"Get the ``quota`` *root*'s resource usage and limits. This method is part of "
"the IMAP4 QUOTA extension defined in rfc2087."
msgstr ""

#: ../Doc/library/imaplib.rst:303
msgid ""
"Get the list of ``quota`` ``roots`` for the named *mailbox*. This method is "
"part of the IMAP4 QUOTA extension defined in rfc2087."
msgstr ""

#: ../Doc/library/imaplib.rst:309
msgid ""
"List mailbox names in *directory* matching *pattern*.  *directory* defaults "
"to the top-level mail folder, and *pattern* defaults to match anything.  "
"Returned data contains a list of ``LIST`` responses."
msgstr ""

#: ../Doc/library/imaplib.rst:316
msgid ""
"Identify the client using a plaintext password. The *password* will be "
"quoted."
msgstr ""

#: ../Doc/library/imaplib.rst:321
msgid ""
"Force use of ``CRAM-MD5`` authentication when identifying the client to "
"protect the password.  Will only work if the server ``CAPABILITY`` response "
"includes the phrase ``AUTH=CRAM-MD5``."
msgstr ""

#: ../Doc/library/imaplib.rst:328
msgid "Shutdown connection to server. Returns server ``BYE`` response."
msgstr ""

#: ../Doc/library/imaplib.rst:333
msgid ""
"List subscribed mailbox names in directory matching pattern. *directory* "
"defaults to the top level directory and *pattern* defaults to match any "
"mailbox. Returned data are tuples of message part envelope and data."
msgstr ""

#: ../Doc/library/imaplib.rst:340
msgid "Show my ACLs for a mailbox (i.e. the rights that I have on mailbox)."
msgstr ""

#: ../Doc/library/imaplib.rst:345
msgid "Returns IMAP namespaces as defined in :rfc:`2342`."
msgstr ""

#: ../Doc/library/imaplib.rst:350
msgid "Send ``NOOP`` to server."
msgstr ""

#: ../Doc/library/imaplib.rst:355
msgid ""
"Opens socket to *port* at *host*.  This method is implicitly called by the :"
"class:`IMAP4` constructor.  The connection objects established by this "
"method will be used in the :meth:`IMAP4.read`, :meth:`IMAP4.readline`, :meth:"
"`IMAP4.send`, and :meth:`IMAP4.shutdown` methods.  You may override this "
"method."
msgstr ""

#: ../Doc/library/imaplib.rst:364
msgid ""
"Fetch truncated part of a message. Returned data is a tuple of message part "
"envelope and data."
msgstr ""

#: ../Doc/library/imaplib.rst:370
msgid ""
"Assume authentication as *user*. Allows an authorised administrator to proxy "
"into any user's mailbox."
msgstr ""

#: ../Doc/library/imaplib.rst:376
msgid ""
"Reads *size* bytes from the remote server. You may override this method."
msgstr ""

#: ../Doc/library/imaplib.rst:381
msgid "Reads one line from the remote server. You may override this method."
msgstr ""

#: ../Doc/library/imaplib.rst:386
msgid ""
"Prompt server for an update. Returned data is ``None`` if no new messages, "
"else value of ``RECENT`` response."
msgstr ""

#: ../Doc/library/imaplib.rst:392
msgid "Rename mailbox named *oldmailbox* to *newmailbox*."
msgstr ""

#: ../Doc/library/imaplib.rst:397
msgid ""
"Return data for response *code* if received, or ``None``. Returns the given "
"code, instead of the usual type."
msgstr ""

#: ../Doc/library/imaplib.rst:403
msgid ""
"Search mailbox for matching messages.  *charset* may be ``None``, in which "
"case no ``CHARSET`` will be specified in the request to the server.  The "
"IMAP protocol requires that at least one criterion be specified; an "
"exception will be raised when the server returns an error.  *charset* must "
"be ``None`` if the ``UTF8=ACCEPT`` capability was enabled using the :meth:"
"`enable` command."
msgstr ""

#: ../Doc/library/imaplib.rst:410
msgid "Example::"
msgstr "Exemple ::"

#: ../Doc/library/imaplib.rst:421
msgid ""
"Select a mailbox. Returned data is the count of messages in *mailbox* "
"(``EXISTS`` response).  The default *mailbox* is ``'INBOX'``.  If the "
"*readonly* flag is set, modifications to the mailbox are not allowed."
msgstr ""

#: ../Doc/library/imaplib.rst:428
msgid "Sends ``data`` to the remote server. You may override this method."
msgstr ""

#: ../Doc/library/imaplib.rst:433
msgid ""
"Set an ``ACL`` for *mailbox*. The method is non-standard, but is supported "
"by the ``Cyrus`` server."
msgstr ""

#: ../Doc/library/imaplib.rst:439
msgid ""
"Set ``ANNOTATION``\\ s for *mailbox*. The method is non-standard, but is "
"supported by the ``Cyrus`` server."
msgstr ""

#: ../Doc/library/imaplib.rst:445
msgid ""
"Set the ``quota`` *root*'s resource *limits*. This method is part of the "
"IMAP4 QUOTA extension defined in rfc2087."
msgstr ""

#: ../Doc/library/imaplib.rst:451
msgid ""
"Close connection established in ``open``.  This method is implicitly called "
"by :meth:`IMAP4.logout`.  You may override this method."
msgstr ""

#: ../Doc/library/imaplib.rst:457
msgid "Returns socket instance used to connect to server."
msgstr ""

#: ../Doc/library/imaplib.rst:462
msgid ""
"The ``sort`` command is a variant of ``search`` with sorting semantics for "
"the results.  Returned data contains a space separated list of matching "
"message numbers."
msgstr ""

#: ../Doc/library/imaplib.rst:466
msgid ""
"Sort has two arguments before the *search_criterion* argument(s); a "
"parenthesized list of *sort_criteria*, and the searching *charset*.  Note "
"that unlike ``search``, the searching *charset* argument is mandatory.  "
"There is also a ``uid sort`` command which corresponds to ``sort`` the way "
"that ``uid search`` corresponds to ``search``.  The ``sort`` command first "
"searches the mailbox for messages that match the given searching criteria "
"using the charset argument for the interpretation of strings in the "
"searching criteria.  It then returns the numbers of matching messages."
msgstr ""

#: ../Doc/library/imaplib.rst:475 ../Doc/library/imaplib.rst:546
msgid "This is an ``IMAP4rev1`` extension command."
msgstr ""

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

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

#: ../Doc/library/imaplib.rst:495
msgid "Request named status conditions for *mailbox*."
msgstr ""

#: ../Doc/library/imaplib.rst:500
msgid ""
"Alters flag dispositions for messages in mailbox.  *command* is specified by "
"section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-"
"FLAGS\", optionally with a suffix of \".SILENT\"."
msgstr ""

#: ../Doc/library/imaplib.rst:504
msgid "For example, to set the delete flag on all messages::"
msgstr ""

#: ../Doc/library/imaplib.rst:513
msgid ""
"Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` "
"(the IMAP protocol).  However, imaplib has historically allowed creation of "
"such tags, and popular IMAP servers, such as Gmail, accept and produce such "
"flags.  There are non-Python programs which also create such tags.  Although "
"it is an RFC violation and IMAP clients and servers are supposed to be "
"strict, imaplib nonetheless continues to allow such tags to be created for "
"backward compatibility reasons, and as of python 3.6, handles them if they "
"are sent from the server, since this improves real-world compatibility."
msgstr ""

#: ../Doc/library/imaplib.rst:525
msgid "Subscribe to new mailbox."
msgstr ""

#: ../Doc/library/imaplib.rst:530
msgid ""
"The ``thread`` command is a variant of ``search`` with threading semantics "
"for the results.  Returned data contains a space separated list of thread "
"members."
msgstr ""

#: ../Doc/library/imaplib.rst:533
msgid ""
"Thread members consist of zero or more messages numbers, delimited by "
"spaces, indicating successive parent and child."
msgstr ""

#: ../Doc/library/imaplib.rst:536
msgid ""
"Thread has two arguments before the *search_criterion* argument(s); a "
"*threading_algorithm*, and the searching *charset*.  Note that unlike "
"``search``, the searching *charset* argument is mandatory.  There is also a "
"``uid thread`` command which corresponds to ``thread`` the way that ``uid "
"search`` corresponds to ``search``.  The ``thread`` command first searches "
"the mailbox for messages that match the given searching criteria using the "
"charset argument for the interpretation of strings in the searching "
"criteria. It then returns the matching messages threaded according to the "
"specified threading algorithm."
msgstr ""

#: ../Doc/library/imaplib.rst:551
msgid ""
"Execute command args with messages identified by UID, rather than message "
"number.  Returns response appropriate to command.  At least one argument "
"must be supplied; if none are provided, the server will return an error and "
"an exception will be raised."
msgstr ""

#: ../Doc/library/imaplib.rst:559
msgid "Unsubscribe from old mailbox."
msgstr ""

#: ../Doc/library/imaplib.rst:564
msgid ""
"Allow simple extension commands notified by server in ``CAPABILITY`` "
"response."
msgstr ""

#: ../Doc/library/imaplib.rst:567
msgid "The following attributes are defined on instances of :class:`IMAP4`:"
msgstr ""

#: ../Doc/library/imaplib.rst:571
msgid ""
"The most recent supported protocol in the ``CAPABILITY`` response from the "
"server."
msgstr ""

#: ../Doc/library/imaplib.rst:577
msgid ""
"Integer value to control debugging output.  The initialize value is taken "
"from the module variable ``Debug``.  Values greater than three trace each "
"command."
msgstr ""

#: ../Doc/library/imaplib.rst:583
msgid ""
"Boolean value that is normally ``False``, but is set to ``True`` if an :meth:"
"`enable` command is successfully issued for the ``UTF8=ACCEPT`` capability."
msgstr ""

#: ../Doc/library/imaplib.rst:593
msgid "IMAP4 Example"
msgstr ""

#: ../Doc/library/imaplib.rst:595
msgid ""
"Here is a minimal example (without error checking) that opens a mailbox and "
"retrieves and prints all messages::"
msgstr ""