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\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/imaplib.rst:2
msgid ":mod:`imaplib` --- IMAP4 protocol client"
msgstr ""

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

#: 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 ""

#: 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/imaplib.rst:31
msgid ""
"Three classes are provided by the :mod:`imaplib` module, :class:`IMAP4` is "
"the base class:"
msgstr ""

#: library/imaplib.rst:37
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. The optional "
"*timeout* parameter specifies a timeout in seconds for the connection "
"attempt. If timeout is not given or is None, the global default socket "
"timeout is used."
msgstr ""

#: library/imaplib.rst:44
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 ""

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

#: library/imaplib.rst:124
msgid "The optional *timeout* parameter was added."
msgstr ""

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

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

#: library/imaplib.rst:71
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 ""

#: library/imaplib.rst:78
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 ""

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

#: library/imaplib.rst:90
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 ""

#: library/imaplib.rst:99
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 ""

#: library/imaplib.rst:105
msgid ""
"The optional *timeout* parameter specifies a timeout in seconds for the "
"connection attempt. If timeout is not given or is None, the global default "
"socket timeout is used."
msgstr ""

#: library/imaplib.rst:109
msgid "*ssl_context* parameter was added."
msgstr ""

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

#: library/imaplib.rst:119
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 ""

#: library/imaplib.rst:127
msgid "The second subclass allows for connections created by a child process:"
msgstr ""

#: library/imaplib.rst:132
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 ""

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

#: library/imaplib.rst:142
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 ""

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

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

#: library/imaplib.rst:159
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 ""

#: library/imaplib.rst:169
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 ""

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

#: library/imaplib.rst:179
msgid ""
"Documents describing the protocol, sources for servers implementing it, by "
"the University of Washington's IMAP Information Center can all be found at "
"(**Source Code**) https://github.com/uw-imap/imap (**Not Maintained**)."
msgstr ""

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

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

#: library/imaplib.rst:192
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 ""

#: library/imaplib.rst:200
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 "
"``bytes``, 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 ""

#: library/imaplib.rst:206
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 ""

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

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

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

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

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

#: library/imaplib.rst:231
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 ""

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

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

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

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

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

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

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

#: library/imaplib.rst:274
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 ""

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

#: library/imaplib.rst:284
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 ""

#: library/imaplib.rst:291
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 ""

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

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

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

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

#: library/imaplib.rst:322
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 ""

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

#: library/imaplib.rst:334
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 ""

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

#: library/imaplib.rst:343
msgid "The method no longer ignores silently arbitrary exceptions."
msgstr ""

#: library/imaplib.rst:349
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 ""

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

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

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

#: library/imaplib.rst:371
msgid ""
"Opens socket to *port* at *host*. The optional *timeout* parameter specifies "
"a timeout in seconds for the connection attempt. If timeout is not given or "
"is None, the global default socket timeout is used. Also note that if the "
"*timeout* parameter is set to be zero, it will raise a :class:`ValueError` "
"to reject creating a non-blocking socket. 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 ""

#: library/imaplib.rst:390
msgid ""
"Raises an :ref:`auditing event <auditing>` ``imaplib.open`` with arguments "
"``self``, ``host``, ``port``."
msgstr ""

#: library/imaplib.rst:383
msgid "The *timeout* parameter was added."
msgstr ""

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

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

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

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

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

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

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

#: library/imaplib.rst:427
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 ""

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

#: library/imaplib.rst:445
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 ""

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

#: library/imaplib.rst:463
msgid ""
"Raises an :ref:`auditing event <auditing>` ``imaplib.send`` with arguments "
"``self``, ``data``."
msgstr ""

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

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

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

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

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

#: library/imaplib.rst:488
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 ""

#: library/imaplib.rst:492
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 ""

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

#: library/imaplib.rst:506
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 ""

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

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

#: library/imaplib.rst:526
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 ""

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

#: library/imaplib.rst:539
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 ""

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

#: library/imaplib.rst:556
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 ""

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

#: library/imaplib.rst:562
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 ""

#: library/imaplib.rst:577
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 ""

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

#: library/imaplib.rst:589
msgid ""
":meth:`imaplib.IMAP4.unselect` frees server's resources associated with the "
"selected mailbox and returns the server to the authenticated state. This "
"command performs the same actions as :meth:`imaplib.IMAP4.close`, except "
"that no messages are permanently removed from the currently selected mailbox."
msgstr ""

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

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

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

#: library/imaplib.rst:612
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 ""

#: library/imaplib.rst:618
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 ""

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

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