python-docs-fr/library/imaplib.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 1990-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 2.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\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:19
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 "Three exceptions are defined as attributes of the :class:`IMAP4` class:"
msgstr ""

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

#: ../Doc/library/imaplib.rst:51
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:58
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:63
msgid "There's also a subclass for secure connections:"
msgstr ""

#: ../Doc/library/imaplib.rst:68
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.  *keyfile* and *certfile* are also optional - they can contain a "
"PEM formatted private key and certificate chain file for the SSL connection."
msgstr ""

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

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

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

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

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

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

#: ../Doc/library/imaplib.rst:108
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 (as returned by :func:`time.localtime`), or a "
"double-quoted string.  In the last case, it is assumed to already be in the "
"correct format."
msgstr ""

#: ../Doc/library/imaplib.rst:116
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:120
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:126
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:134
msgid "IMAP4 Objects"
msgstr ""

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

#: ../Doc/library/imaplib.rst:139
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:147
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:153
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:159
msgid "An :class:`IMAP4` instance has the following methods:"
msgstr ""

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

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

#: ../Doc/library/imaplib.rst:171
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:174
msgid "*authobject* must be a callable object::"
msgstr ""

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

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

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

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

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

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

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

#: ../Doc/library/imaplib.rst:218
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:225
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:232
msgid ""
"Get the ``ACL``\\ s for *mailbox*. The method is non-standard, but is "
"supported by the ``Cyrus`` server."
msgstr ""

#: ../Doc/library/imaplib.rst:238
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:246
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:254
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:262
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:269
msgid ""
"Identify the client using a plaintext password. The *password* will be "
"quoted."
msgstr ""

#: ../Doc/library/imaplib.rst:274
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:283
msgid "Shutdown connection to server. Returns server ``BYE`` response."
msgstr ""

#: ../Doc/library/imaplib.rst:288
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:295
msgid "Show my ACLs for a mailbox (i.e. the rights that I have on mailbox)."
msgstr ""

#: ../Doc/library/imaplib.rst:302
msgid "Returns IMAP namespaces as defined in RFC2342."
msgstr ""

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

#: ../Doc/library/imaplib.rst:314
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:323
msgid ""
"Fetch truncated part of a message. Returned data is a tuple of message part "
"envelope and data."
msgstr ""

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

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

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

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

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

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

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

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

#: ../Doc/library/imaplib.rst:380
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:387
msgid "Sends ``data`` to the remote server. You may override this method."
msgstr ""

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

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

#: ../Doc/library/imaplib.rst:406
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:414
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:420
msgid "Returns socket instance used to connect to server."
msgstr ""

#: ../Doc/library/imaplib.rst:425
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:429
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:438 ../Doc/library/imaplib.rst:483
msgid "This is an ``IMAP4rev1`` extension command."
msgstr ""

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

#: ../Doc/library/imaplib.rst:448
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:452
msgid "For example, to set the delete flag on all messages::"
msgstr ""

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

#: ../Doc/library/imaplib.rst:467
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:470
msgid ""
"Thread members consist of zero or more messages numbers, delimited by "
"spaces, indicating successive parent and child."
msgstr ""

#: ../Doc/library/imaplib.rst:473
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:490
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:498
msgid "Unsubscribe from old mailbox."
msgstr ""

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

#: ../Doc/library/imaplib.rst:505
msgid "Instances of :class:`IMAP4_SSL` have just one additional method:"
msgstr ""

#: ../Doc/library/imaplib.rst:510
msgid ""
"Returns SSLObject instance used for the secure connection with the server."
msgstr ""

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

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

#: ../Doc/library/imaplib.rst:523
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:530
msgid "IMAP4 Example"
msgstr ""

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