forked from AFPy/python-docs-fr
321 lines
13 KiB
Plaintext
321 lines
13 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.5\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:42+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/email.generator.rst:2
|
|
msgid ":mod:`email.generator`: Generating MIME documents"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:7
|
|
msgid "**Source code:** :source:`Lib/email/generator.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:11
|
|
msgid ""
|
|
"One of the most common tasks is to generate the flat text of the email "
|
|
"message represented by a message object structure. You will need to do this "
|
|
"if you want to send your message via the :mod:`smtplib` module or the :mod:"
|
|
"`nntplib` module, or print the message on the console. Taking a message "
|
|
"object structure and producing a flat text document is the job of the :class:"
|
|
"`Generator` class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:17
|
|
msgid ""
|
|
"Again, 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 transformation from flat text, to a "
|
|
"message structure via the :class:`~email.parser.Parser` class, and back to "
|
|
"flat text, is idempotent (the input is identical to the output) [#]_. On "
|
|
"the other hand, using the Generator on a :class:`~email.message.Message` "
|
|
"constructed by program may result in changes to the :class:`~email.message."
|
|
"Message` object as defaults are filled in."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:28
|
|
msgid ""
|
|
":class:`bytes` output can be generated using the :class:`BytesGenerator` "
|
|
"class. If the message object structure contains non-ASCII bytes, this "
|
|
"generator's :meth:`~BytesGenerator.flatten` method will emit the original "
|
|
"bytes. Parsing a binary message and then flattening it with :class:"
|
|
"`BytesGenerator` should be idempotent for standards compliant messages."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:34
|
|
msgid ""
|
|
"Here are the public methods of the :class:`Generator` class, imported from "
|
|
"the :mod:`email.generator` module:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:40
|
|
msgid ""
|
|
"The constructor for the :class:`Generator` class takes a :term:`file-like "
|
|
"object` called *outfp* for an argument. *outfp* must support the :meth:"
|
|
"`write` method and be usable as the output file for the :func:`print` "
|
|
"function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:44
|
|
msgid ""
|
|
"Optional *mangle_from_* is a flag that, when ``True``, puts a ``>`` "
|
|
"character in front of any line in the body that starts exactly as ``From``, "
|
|
"i.e. ``From`` followed by a space at the beginning of the line. This is the "
|
|
"only guaranteed portable way to avoid having such lines be mistaken for a "
|
|
"Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH "
|
|
"FORMAT IS BAD <https://www.jwz.org/doc/content-length.html>`_ for details). "
|
|
"*mangle_from_* defaults to ``True``, but you might want to set this to "
|
|
"``False`` if you are not writing Unix mailbox format files."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:53
|
|
msgid ""
|
|
"Optional *maxheaderlen* specifies the longest length for a non-continued "
|
|
"header. When a header line is longer than *maxheaderlen* (in characters, "
|
|
"with tabs expanded to 8 spaces), the header will be split as defined in the :"
|
|
"class:`~email.header.Header` class. Set to zero to disable header wrapping. "
|
|
"The default is 78, as recommended (but not required) by :rfc:`2822`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:59 ../Doc/library/email.generator.rst:141
|
|
msgid ""
|
|
"The *policy* keyword specifies a :mod:`~email.policy` object that controls a "
|
|
"number of aspects of the generator's operation. If no *policy* is "
|
|
"specified, then the *policy* attached to the message object passed to :attr:"
|
|
"`flatten` is used."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:64 ../Doc/library/email.generator.rst:146
|
|
msgid "Added the *policy* keyword."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:66
|
|
msgid "The other public :class:`Generator` methods are:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:71
|
|
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. Subparts are visited depth-first and the resulting text will be "
|
|
"properly MIME encoded."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:76 ../Doc/library/email.generator.rst:172
|
|
msgid ""
|
|
"Optional *unixfrom* is a flag that forces the printing of the envelope "
|
|
"header delimiter before the first :rfc:`2822` header of the root message "
|
|
"object. If the root object has no envelope header, a standard one is "
|
|
"crafted. By default, this is set to ``False`` to inhibit the printing of "
|
|
"the envelope delimiter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:82 ../Doc/library/email.generator.rst:178
|
|
msgid "Note that for subparts, no envelope header is ever printed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:84
|
|
msgid ""
|
|
"Optional *linesep* specifies the line separator character used to terminate "
|
|
"lines in the output. If specified it overrides the value specified by the "
|
|
"*msg*\\'s or ``Generator``\\'s ``policy``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:88
|
|
msgid ""
|
|
"Because strings cannot represent non-ASCII bytes, if the policy that applies "
|
|
"when ``flatten`` is run has :attr:`~email.policy.Policy.cte_type` set to "
|
|
"``8bit``, ``Generator`` will operate as if it were set to ``7bit``. This "
|
|
"means that messages parsed with a Bytes parser that have a :mailheader:"
|
|
"`Content-Transfer-Encoding` of ``8bit`` will be converted to a use a "
|
|
"``7bit`` Content-Transfer-Encoding. Non-ASCII bytes in the headers will be :"
|
|
"rfc:`2047` encoded with a charset of ``unknown-8bit``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:96
|
|
msgid ""
|
|
"Added support for re-encoding ``8bit`` message bodies, and the *linesep* "
|
|
"argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:102
|
|
msgid ""
|
|
"Return an independent clone of this :class:`Generator` instance with the "
|
|
"exact same options."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:107
|
|
msgid ""
|
|
"Write the string *s* to the underlying file object, i.e. *outfp* passed to :"
|
|
"class:`Generator`'s constructor. This provides just enough file-like API "
|
|
"for :class:`Generator` instances to be used in the :func:`print` function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:111
|
|
msgid ""
|
|
"As a convenience, see the :class:`~email.message.Message` methods :meth:"
|
|
"`~email.message.Message.as_string` and ``str(aMessage)``, a.k.a. :meth:"
|
|
"`~email.message.Message.__str__`, which simplify the generation of a "
|
|
"formatted string representation of a message object. For more detail, see :"
|
|
"mod:`email.message`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:120
|
|
msgid ""
|
|
"The constructor for the :class:`BytesGenerator` class takes a binary :term:"
|
|
"`file-like object` called *outfp* for an argument. *outfp* must support a :"
|
|
"meth:`write` method that accepts binary data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:124
|
|
msgid ""
|
|
"Optional *mangle_from_* is a flag that, when ``True``, puts a ``>`` "
|
|
"character in front of any line in the body that starts exactly as ``From``, "
|
|
"i.e. ``From`` followed by a space at the beginning of the line. This is the "
|
|
"only guaranteed portable way to avoid having such lines be mistaken for a "
|
|
"Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH "
|
|
"FORMAT IS BAD <https://www.jwz.org/doc/content-length.html>`_ for details). "
|
|
"*mangle_from_* defaults to ``True``, but you might want to set this to "
|
|
"``False`` if you are not writing Unix mailbox format files."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:133
|
|
msgid ""
|
|
"Optional *maxheaderlen* specifies the longest length for a non-continued "
|
|
"header. When a header line is longer than *maxheaderlen* (in characters, "
|
|
"with tabs expanded to 8 spaces), the header will be split as defined in the :"
|
|
"class:`~email.header.Header` class. Set to zero to disable header "
|
|
"wrapping. The default is 78, as recommended (but not required) by :rfc:"
|
|
"`2822`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:148
|
|
msgid "The other public :class:`BytesGenerator` methods are:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:153
|
|
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. Subparts are visited depth-first and the resulting text will "
|
|
"be properly MIME encoded. If the :mod:`~email.policy` option :attr:`~email."
|
|
"policy.Policy.cte_type` is ``8bit`` (the default), then any bytes with the "
|
|
"high bit set in the original parsed message that have not been modified will "
|
|
"be copied faithfully to the output. If ``cte_type`` is ``7bit``, the bytes "
|
|
"will be converted as needed using an ASCII-compatible Content-Transfer-"
|
|
"Encoding. In particular, RFC-invalid non-ASCII bytes in headers will be "
|
|
"encoded using the MIME ``unknown-8bit`` character set, thus rendering them "
|
|
"RFC-compliant."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:168
|
|
msgid ""
|
|
"Messages parsed with a Bytes parser that have a :mailheader:`Content-"
|
|
"Transfer-Encoding` of 8bit will be reconstructed as 8bit if they have not "
|
|
"been modified."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:180
|
|
msgid ""
|
|
"Optional *linesep* specifies the line separator character used to terminate "
|
|
"lines in the output. If specified it overrides the value specified by the "
|
|
"``Generator``\\ or *msg*\\ 's ``policy``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:186
|
|
msgid ""
|
|
"Return an independent clone of this :class:`BytesGenerator` instance with "
|
|
"the exact same options."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:191
|
|
msgid ""
|
|
"Write the string *s* to the underlying file object. *s* is encoded using "
|
|
"the ``ASCII`` codec and written to the *write* method of the *outfp* "
|
|
"*outfp* passed to the :class:`BytesGenerator`'s constructor. This provides "
|
|
"just enough file-like API for :class:`BytesGenerator` instances to be used "
|
|
"in the :func:`print` function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:199
|
|
msgid ""
|
|
"The :mod:`email.generator` module also provides a derived class, called :"
|
|
"class:`DecodedGenerator` which is like the :class:`Generator` base class, "
|
|
"except that non-\\ :mimetype:`text` parts are substituted with a format "
|
|
"string representing the part."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:207
|
|
msgid ""
|
|
"This class, derived from :class:`Generator` walks through all the subparts "
|
|
"of a message. If the subpart is of main type :mimetype:`text`, then it "
|
|
"prints the decoded payload of the subpart. Optional *_mangle_from_* and "
|
|
"*maxheaderlen* are as with the :class:`Generator` base class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:212
|
|
msgid ""
|
|
"If the subpart is not of main type :mimetype:`text`, optional *fmt* is a "
|
|
"format string that is used instead of the message payload. *fmt* is expanded "
|
|
"with the following keywords, ``%(keyword)s`` format:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:216
|
|
msgid "``type`` -- Full MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:218
|
|
msgid "``maintype`` -- Main MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:220
|
|
msgid "``subtype`` -- Sub-MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:222
|
|
msgid "``filename`` -- Filename of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:224
|
|
msgid ""
|
|
"``description`` -- Description associated with the non-\\ :mimetype:`text` "
|
|
"part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:226
|
|
msgid ""
|
|
"``encoding`` -- Content transfer encoding of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:228
|
|
msgid "The default value for *fmt* is ``None``, meaning ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:234
|
|
msgid "Footnotes"
|
|
msgstr "Notes"
|
|
|
|
#: ../Doc/library/email.generator.rst:235
|
|
msgid ""
|
|
"This statement assumes that you use the appropriate setting for the "
|
|
"``unixfrom`` argument, and that you set maxheaderlen=0 (which will preserve "
|
|
"whatever the input line lengths were). It is also not strictly true, since "
|
|
"in many cases runs of whitespace in headers are collapsed into single "
|
|
"blanks. The latter is a bug that will eventually be fixed."
|
|
msgstr ""
|