forked from AFPy/python-docs-fr
279 lines
9.9 KiB
Plaintext
279 lines
9.9 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: 2020-08-24 09:01+0200\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/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 <provisional package>`"
|
|
msgstr ""
|