# 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 \n" "Language-Team: FRENCH \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 `: 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 ` ``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 ` ``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 ""