# 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/email.generator.rst:2 msgid ":mod:`email.generator`: Generating MIME documents" msgstr "" #: library/email.generator.rst:7 #, fuzzy msgid "**Source code:** :source:`Lib/email/generator.py`" msgstr "**Code source :** :source:`Lib/email/iterators.py`" #: library/email.generator.rst:11 msgid "" "One of the most common tasks is to generate the flat (serialized) version of " "the email message represented by a message object structure. You will need " "to do this if you want to send your message via :meth:`smtplib.SMTP." "sendmail` or the :mod:`nntplib` module, or print the message on the " "console. Taking a message object structure and producing a serialized " "representation is the job of the generator classes." msgstr "" #: library/email.generator.rst:18 msgid "" "As with the :mod:`email.parser` module, you aren't limited to the " "functionality of the bundled generator; you could write one from scratch " "yourself. However the bundled generator knows how to generate most email in " "a standards-compliant way, should handle MIME and non-MIME email messages " "just fine, and is designed so that the bytes-oriented parsing and generation " "operations are inverses, assuming the same non-transforming :mod:`~email." "policy` is used for both. That is, parsing the serialized byte stream via " "the :class:`~email.parser.BytesParser` class and then regenerating the " "serialized byte stream using :class:`BytesGenerator` should produce output " "identical to the input [#]_. (On the other hand, using the generator on an :" "class:`~email.message.EmailMessage` constructed by program may result in " "changes to the :class:`~email.message.EmailMessage` object as defaults are " "filled in.)" msgstr "" #: library/email.generator.rst:32 msgid "" "The :class:`Generator` class can be used to flatten a message into a text " "(as opposed to binary) serialized representation, but since Unicode cannot " "represent binary data directly, the message is of necessity transformed into " "something that contains only ASCII characters, using the standard email RFC " "Content Transfer Encoding techniques for encoding email messages for " "transport over channels that are not \"8 bit clean\"." msgstr "" #: library/email.generator.rst:39 msgid "" "To accommodate reproducible processing of SMIME-signed messages :class:" "`Generator` disables header folding for message parts of type ``multipart/" "signed`` and all subparts." msgstr "" #: library/email.generator.rst:47 msgid "" "Return a :class:`BytesGenerator` object that will write any message provided " "to the :meth:`flatten` method, or any surrogateescape encoded text provided " "to the :meth:`write` method, to the :term:`file-like object` *outfp*. " "*outfp* must support a ``write`` method that accepts binary data." msgstr "" #: library/email.generator.rst:153 msgid "" "If optional *mangle_from_* is ``True``, put a ``>`` character in front of " "any line in the body that starts with the exact string ``\"From \"``, that " "is ``From`` followed by a space at the beginning of a line. *mangle_from_* " "defaults to the value of the :attr:`~email.policy.Policy.mangle_from_` " "setting of the *policy* (which is ``True`` for the :data:`~email.policy." "compat32` policy and ``False`` for all others). *mangle_from_* is intended " "for use when messages are stored in Unix mbox format (see :mod:`mailbox` and " "`WHY THE CONTENT-LENGTH FORMAT IS BAD `_)." msgstr "" #: library/email.generator.rst:163 msgid "" "If *maxheaderlen* is not ``None``, refold any header lines that are longer " "than *maxheaderlen*, or if ``0``, do not rewrap any headers. If " "*manheaderlen* is ``None`` (the default), wrap headers and other message " "lines according to the *policy* settings." msgstr "" #: library/email.generator.rst:168 msgid "" "If *policy* is specified, use that policy to control message generation. If " "*policy* is ``None`` (the default), use the policy associated with the :" "class:`~email.message.Message` or :class:`~email.message.EmailMessage` " "object passed to ``flatten`` to control the message generation. See :mod:" "`email.policy` for details on what *policy* controls." msgstr "" #: library/email.generator.rst:174 msgid "Added the *policy* keyword." msgstr "" #: library/email.generator.rst:176 msgid "" "The default behavior of the *mangle_from_* and *maxheaderlen* parameters is " "to follow the policy." msgstr "" #: library/email.generator.rst:83 msgid "" "Print the textual representation of the message object structure rooted at " "*msg* to the output file specified when the :class:`BytesGenerator` instance " "was created." msgstr "" #: library/email.generator.rst:87 msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit`` (the default), copy any headers in the original parsed message that " "have not been modified to the output with any bytes with the high bit set " "reproduced as in the original, and preserve the non-ASCII :mailheader:" "`Content-Transfer-Encoding` of any body parts that have them. If " "``cte_type`` is ``7bit``, convert the bytes with the high bit set as needed " "using an ASCII-compatible :mailheader:`Content-Transfer-Encoding`. That is, " "transform parts with non-ASCII :mailheader:`Content-Transfer-Encoding` (:" "mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII compatible :" "mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid non-ASCII " "bytes in headers using the MIME ``unknown-8bit`` character set, thus " "rendering them RFC-compliant." msgstr "" #: library/email.generator.rst:104 library/email.generator.rst:197 msgid "" "If *unixfrom* is ``True``, print the envelope header delimiter used by the " "Unix mailbox format (see :mod:`mailbox`) before the first of the :rfc:`5322` " "headers of the root message object. If the root object has no envelope " "header, craft a standard one. The default is ``False``. Note that for " "subparts, no envelope header is ever printed." msgstr "" #: library/email.generator.rst:110 library/email.generator.rst:203 msgid "" "If *linesep* is not ``None``, use it as the separator character between all " "the lines of the flattened message. If *linesep* is ``None`` (the default), " "use the value specified in the *policy*." msgstr "" #: library/email.generator.rst:119 msgid "" "Return an independent clone of this :class:`BytesGenerator` instance with " "the exact same option settings, and *fp* as the new *outfp*." msgstr "" #: library/email.generator.rst:125 msgid "" "Encode *s* using the ``ASCII`` codec and the ``surrogateescape`` error " "handler, and pass it to the *write* method of the *outfp* passed to the :" "class:`BytesGenerator`'s constructor." msgstr "" #: library/email.generator.rst:130 msgid "" "As a convenience, :class:`~email.message.EmailMessage` provides the methods :" "meth:`~email.message.EmailMessage.as_bytes` and ``bytes(aMessage)`` (a.k.a. :" "meth:`~email.message.EmailMessage.__bytes__`), which simplify the generation " "of a serialized binary representation of a message object. For more detail, " "see :mod:`email.message`." msgstr "" #: library/email.generator.rst:137 msgid "" "Because strings cannot represent binary data, the :class:`Generator` class " "must convert any binary data in any message it flattens to an ASCII " "compatible format, by converting them to an ASCII compatible :mailheader:" "`Content-Transfer_Encoding`. Using the terminology of the email RFCs, you " "can think of this as :class:`Generator` serializing to an I/O stream that is " "not \"8 bit clean\". In other words, most applications will want to be " "using :class:`BytesGenerator`, and not :class:`Generator`." msgstr "" #: library/email.generator.rst:148 msgid "" "Return a :class:`Generator` object that will write any message provided to " "the :meth:`flatten` method, or any text provided to the :meth:`write` " "method, to the :term:`file-like object` *outfp*. *outfp* must support a " "``write`` method that accepts string data." msgstr "" #: library/email.generator.rst:182 msgid "" "Print the textual representation of the message object structure rooted at " "*msg* to the output file specified when the :class:`Generator` instance was " "created." msgstr "" #: library/email.generator.rst:186 msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit``, generate the message as if the option were set to ``7bit``. (This " "is required because strings cannot represent non-ASCII bytes.) Convert any " "bytes with the high bit set as needed using an ASCII-compatible :mailheader:" "`Content-Transfer-Encoding`. That is, transform parts with non-ASCII :" "mailheader:`Content-Transfer-Encoding` (:mailheader:`Content-Transfer-" "Encoding: 8bit`) to an ASCII compatible :mailheader:`Content-Transfer-" "Encoding`, and encode RFC-invalid non-ASCII bytes in headers using the MIME " "``unknown-8bit`` character set, thus rendering them RFC-compliant." msgstr "" #: library/email.generator.rst:209 msgid "" "Added support for re-encoding ``8bit`` message bodies, and the *linesep* " "argument." msgstr "" #: library/email.generator.rst:216 msgid "" "Return an independent clone of this :class:`Generator` instance with the " "exact same options, and *fp* as the new *outfp*." msgstr "" #: library/email.generator.rst:222 msgid "" "Write *s* to the *write* method of the *outfp* passed to the :class:" "`Generator`'s constructor. This provides just enough file-like API for :" "class:`Generator` instances to be used in the :func:`print` function." msgstr "" #: library/email.generator.rst:228 msgid "" "As a convenience, :class:`~email.message.EmailMessage` provides the methods :" "meth:`~email.message.EmailMessage.as_string` and ``str(aMessage)`` (a.k.a. :" "meth:`~email.message.EmailMessage.__str__`), which simplify the generation " "of a formatted string representation of a message object. For more detail, " "see :mod:`email.message`." msgstr "" #: library/email.generator.rst:235 msgid "" "The :mod:`email.generator` module also provides a derived class, :class:" "`DecodedGenerator`, which is like the :class:`Generator` base class, except " "that non-\\ :mimetype:`text` parts are not serialized, but are instead " "represented in the output stream by a string derived from a template filled " "in with information about the part." msgstr "" #: library/email.generator.rst:244 msgid "" "Act like :class:`Generator`, except that for any subpart of the message " "passed to :meth:`Generator.flatten`, if the subpart is of main type :" "mimetype:`text`, print the decoded payload of the subpart, and if the main " "type is not :mimetype:`text`, instead of printing it fill in the string " "*fmt* using information from the part and print the resulting filled-in " "string." msgstr "" #: library/email.generator.rst:251 msgid "" "To fill in *fmt*, execute ``fmt % part_info``, where ``part_info`` is a " "dictionary composed of the following keys and values:" msgstr "" #: library/email.generator.rst:254 msgid "``type`` -- Full MIME type of the non-\\ :mimetype:`text` part" msgstr "" #: library/email.generator.rst:256 msgid "``maintype`` -- Main MIME type of the non-\\ :mimetype:`text` part" msgstr "" #: library/email.generator.rst:258 msgid "``subtype`` -- Sub-MIME type of the non-\\ :mimetype:`text` part" msgstr "" #: library/email.generator.rst:260 msgid "``filename`` -- Filename of the non-\\ :mimetype:`text` part" msgstr "" #: library/email.generator.rst:262 msgid "" "``description`` -- Description associated with the non-\\ :mimetype:`text` " "part" msgstr "" #: library/email.generator.rst:264 msgid "" "``encoding`` -- Content transfer encoding of the non-\\ :mimetype:`text` part" msgstr "" #: library/email.generator.rst:266 msgid "If *fmt* is ``None``, use the following default *fmt*:" msgstr "" #: library/email.generator.rst:268 msgid "" "\"[Non-text (%(type)s) part of message omitted, filename %(filename)s]\"" msgstr "" #: library/email.generator.rst:270 msgid "" "Optional *_mangle_from_* and *maxheaderlen* are as with the :class:" "`Generator` base class." msgstr "" #: library/email.generator.rst:275 msgid "Footnotes" msgstr "Notes" #: library/email.generator.rst:276 msgid "" "This statement assumes that you use the appropriate setting for " "``unixfrom``, and that there are no :mod:`policy` settings calling for " "automatic adjustments (for example, :attr:`~email.policy.Policy." "refold_source` must be ``none``, which is *not* the default). It is also " "not 100% true, since if the message does not conform to the RFC standards " "occasionally information about the exact original text is lost during " "parsing error recovery. It is a goal to fix these latter edge cases when " "possible." msgstr ""