forked from AFPy/python-docs-fr
197 lines
7.5 KiB
Plaintext
197 lines
7.5 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-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 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+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:8
|
|
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:14
|
|
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:25
|
|
msgid ""
|
|
"Here are the public methods of the :class:`Generator` class, imported from "
|
|
"the :mod:`email.generator` module:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:31
|
|
msgid ""
|
|
"The constructor for the :class:`Generator` class takes a file-like object "
|
|
"called *outfp* for an argument. *outfp* must support the :meth:`write` "
|
|
"method and be usable as the output file in a Python extended print statement."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:35
|
|
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:44
|
|
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:50
|
|
msgid "The other public :class:`Generator` methods are:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:55
|
|
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:60
|
|
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:66
|
|
msgid "Note that for subparts, no envelope header is ever printed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:73
|
|
msgid ""
|
|
"Return an independent clone of this :class:`Generator` instance with the "
|
|
"exact same options."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:81
|
|
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 extended print statements."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:85
|
|
msgid ""
|
|
"As a convenience, see the methods :meth:`Message.as_string` and "
|
|
"``str(aMessage)``, a.k.a. :meth:`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:90
|
|
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:98
|
|
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:103
|
|
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:107
|
|
msgid "``type`` -- Full MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:109
|
|
msgid "``maintype`` -- Main MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:111
|
|
msgid "``subtype`` -- Sub-MIME type of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:113
|
|
msgid "``filename`` -- Filename of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:115
|
|
msgid ""
|
|
"``description`` -- Description associated with the non-\\ :mimetype:`text` "
|
|
"part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:117
|
|
msgid ""
|
|
"``encoding`` -- Content transfer encoding of the non-\\ :mimetype:`text` part"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:119
|
|
msgid "The default value for *fmt* is ``None``, meaning ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:125
|
|
msgid "The previously deprecated method :meth:`__call__` was removed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/email.generator.rst:130
|
|
msgid "Footnotes"
|
|
msgstr "Notes"
|
|
|
|
#: ../Doc/library/email.generator.rst:131
|
|
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 ""
|