# 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: 2020-08-24 09:01+0200\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/email.contentmanager.rst:2 msgid ":mod:`email.contentmanager`: Managing MIME Content" msgstr "" #: library/email.contentmanager.rst:10 msgid "**Source code:** :source:`Lib/email/contentmanager.py`" msgstr "" #: library/email.contentmanager.rst:14 msgid "[1]_" msgstr "" #: library/email.contentmanager.rst:19 msgid "" "Base class for content managers. Provides the standard registry mechanisms " "to register converters between MIME content and other representations, as " "well as the ``get_content`` and ``set_content`` dispatch methods." msgstr "" #: library/email.contentmanager.rst:26 msgid "" "Look up a handler function based on the ``mimetype`` of *msg* (see next " "paragraph), call it, passing through all arguments, and return the result of " "the call. The expectation is that the handler will extract the payload from " "*msg* and return an object that encodes information about the extracted data." msgstr "" #: library/email.contentmanager.rst:32 msgid "" "To find the handler, look for the following keys in the registry, stopping " "with the first one found:" msgstr "" #: library/email.contentmanager.rst:35 msgid "the string representing the full MIME type (``maintype/subtype``)" msgstr "" #: library/email.contentmanager.rst:36 msgid "the string representing the ``maintype``" msgstr "" #: library/email.contentmanager.rst:37 msgid "the empty string" msgstr "" #: library/email.contentmanager.rst:39 msgid "" "If none of these keys produce a handler, raise a :exc:`KeyError` for the " "full MIME type." msgstr "" #: library/email.contentmanager.rst:45 msgid "" "If the ``maintype`` is ``multipart``, raise a :exc:`TypeError`; otherwise " "look up a handler function based on the type of *obj* (see next paragraph), " "call :meth:`~email.message.EmailMessage.clear_content` on the *msg*, and " "call the handler function, passing through all arguments. The expectation " "is that the handler will transform and store *obj* into *msg*, possibly " "making other changes to *msg* as well, such as adding various MIME headers " "to encode information needed to interpret the stored data." msgstr "" #: library/email.contentmanager.rst:54 msgid "" "To find the handler, obtain the type of *obj* (``typ = type(obj)``), and " "look for the following keys in the registry, stopping with the first one " "found:" msgstr "" #: library/email.contentmanager.rst:58 msgid "the type itself (``typ``)" msgstr "" #: library/email.contentmanager.rst:59 msgid "" "the type's fully qualified name (``typ.__module__ + '.' + typ." "__qualname__``)." msgstr "" #: library/email.contentmanager.rst:61 msgid "the type's qualname (``typ.__qualname__``)" msgstr "" #: library/email.contentmanager.rst:62 msgid "the type's name (``typ.__name__``)." msgstr "" #: library/email.contentmanager.rst:64 msgid "" "If none of the above match, repeat all of the checks above for each of the " "types in the :term:`MRO` (``typ.__mro__``). Finally, if no other key yields " "a handler, check for a handler for the key ``None``. If there is no handler " "for ``None``, raise a :exc:`KeyError` for the fully qualified name of the " "type." msgstr "" #: library/email.contentmanager.rst:70 msgid "" "Also add a :mailheader:`MIME-Version` header if one is not present (see " "also :class:`.MIMEPart`)." msgstr "" #: library/email.contentmanager.rst:76 msgid "" "Record the function *handler* as the handler for *key*. For the possible " "values of *key*, see :meth:`get_content`." msgstr "" #: library/email.contentmanager.rst:82 msgid "" "Record *handler* as the function to call when an object of a type matching " "*typekey* is passed to :meth:`set_content`. For the possible values of " "*typekey*, see :meth:`set_content`." msgstr "" #: library/email.contentmanager.rst:88 msgid "Content Manager Instances" msgstr "" #: library/email.contentmanager.rst:90 msgid "" "Currently the email package provides only one concrete content manager, :" "data:`raw_data_manager`, although more may be added in the future. :data:" "`raw_data_manager` is the :attr:`~email.policy.EmailPolicy.content_manager` " "provided by :attr:`~email.policy.EmailPolicy` and its derivatives." msgstr "" #: library/email.contentmanager.rst:99 msgid "" "This content manager provides only a minimum interface beyond that provided " "by :class:`~email.message.Message` itself: it deals only with text, raw " "byte strings, and :class:`~email.message.Message` objects. Nevertheless, it " "provides significant advantages compared to the base API: ``get_content`` on " "a text part will return a unicode string without the application needing to " "manually decode it, ``set_content`` provides a rich set of options for " "controlling the headers added to a part and controlling the content transfer " "encoding, and it enables the use of the various ``add_`` methods, thereby " "simplifying the creation of multipart messages." msgstr "" #: library/email.contentmanager.rst:111 msgid "" "Return the payload of the part as either a string (for ``text`` parts), an :" "class:`~email.message.EmailMessage` object (for ``message/rfc822`` parts), " "or a ``bytes`` object (for all other non-multipart types). Raise a :exc:" "`KeyError` if called on a ``multipart``. If the part is a ``text`` part and " "*errors* is specified, use it as the error handler when decoding the payload " "to unicode. The default error handler is ``replace``." msgstr "" #: library/email.contentmanager.rst:130 msgid "Add headers and payload to *msg*:" msgstr "" #: library/email.contentmanager.rst:132 msgid "" "Add a :mailheader:`Content-Type` header with a ``maintype/subtype`` value." msgstr "" #: library/email.contentmanager.rst:135 msgid "" "For ``str``, set the MIME ``maintype`` to ``text``, and set the subtype to " "*subtype* if it is specified, or ``plain`` if it is not." msgstr "" #: library/email.contentmanager.rst:137 msgid "" "For ``bytes``, use the specified *maintype* and *subtype*, or raise a :exc:" "`TypeError` if they are not specified." msgstr "" #: library/email.contentmanager.rst:139 msgid "" "For :class:`~email.message.EmailMessage` objects, set the maintype to " "``message``, and set the subtype to *subtype* if it is specified or " "``rfc822`` if it is not. If *subtype* is ``partial``, raise an error " "(``bytes`` objects must be used to construct ``message/partial`` parts)." msgstr "" #: library/email.contentmanager.rst:145 msgid "" "If *charset* is provided (which is valid only for ``str``), encode the " "string to bytes using the specified character set. The default is " "``utf-8``. If the specified *charset* is a known alias for a standard MIME " "charset name, use the standard charset instead." msgstr "" #: library/email.contentmanager.rst:150 msgid "" "If *cte* is set, encode the payload using the specified content transfer " "encoding, and set the :mailheader:`Content-Transfer-Encoding` header to that " "value. Possible values for *cte* are ``quoted-printable``, ``base64``, " "``7bit``, ``8bit``, and ``binary``. If the input cannot be encoded in the " "specified encoding (for example, specifying a *cte* of ``7bit`` for an input " "that contains non-ASCII values), raise a :exc:`ValueError`." msgstr "" #: library/email.contentmanager.rst:158 msgid "" "For ``str`` objects, if *cte* is not set use heuristics to determine the " "most compact encoding." msgstr "" #: library/email.contentmanager.rst:160 msgid "" "For :class:`~email.message.EmailMessage`, per :rfc:`2046`, raise an error if " "a *cte* of ``quoted-printable`` or ``base64`` is requested for *subtype* " "``rfc822``, and for any *cte* other than ``7bit`` for *subtype* ``external-" "body``. For ``message/rfc822``, use ``8bit`` if *cte* is not specified. " "For all other values of *subtype*, use ``7bit``." msgstr "" #: library/email.contentmanager.rst:167 msgid "" "A *cte* of ``binary`` does not actually work correctly yet. The " "``EmailMessage`` object as modified by ``set_content`` is correct, but :" "class:`~email.generator.BytesGenerator` does not serialize it correctly." msgstr "" #: library/email.contentmanager.rst:172 msgid "" "If *disposition* is set, use it as the value of the :mailheader:`Content-" "Disposition` header. If not specified, and *filename* is specified, add the " "header with the value ``attachment``. If *disposition* is not specified and " "*filename* is also not specified, do not add the header. The only valid " "values for *disposition* are ``attachment`` and ``inline``." msgstr "" #: library/email.contentmanager.rst:179 msgid "" "If *filename* is specified, use it as the value of the ``filename`` " "parameter of the :mailheader:`Content-Disposition` header." msgstr "" #: library/email.contentmanager.rst:182 msgid "" "If *cid* is specified, add a :mailheader:`Content-ID` header with *cid* as " "its value." msgstr "" #: library/email.contentmanager.rst:185 msgid "" "If *params* is specified, iterate its ``items`` method and use the resulting " "``(key, value)`` pairs to set additional parameters on the :mailheader:" "`Content-Type` header." msgstr "" #: library/email.contentmanager.rst:189 msgid "" "If *headers* is specified and is a list of strings of the form ``headername: " "headervalue`` or a list of ``header`` objects (distinguished from strings by " "having a ``name`` attribute), add the headers to *msg*." msgstr "" #: library/email.contentmanager.rst:196 msgid "Footnotes" msgstr "Notes" #: library/email.contentmanager.rst:197 msgid "" "Originally added in 3.4 as a :term:`provisional module `" msgstr ""