# 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/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 <https://www.jwz.org/doc/content-"
"length.html>`_)."
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 ""
