forked from AFPy/python-docs-fr
685 lines
22 KiB
Plaintext
685 lines
22 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/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 ""
|