# 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.contentmanager.rst:2

msgid ":mod:`email.contentmanager`: Managing MIME Content"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:10

msgid "as a :term:`provisional module <provisional package>`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:13

msgid "**Source code:** :source:`Lib/email/contentmanager.py`"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:17

msgid ""

"The contentmanager module has been included in the standard library on a :"

"term:`provisional basis <provisional package>`. Backwards incompatible "

"changes (up to and including removal of the module) may occur if deemed "

"necessary by the core developers."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:24

msgid ""

"The :mod:`~email.message` module provides a class that can represent an "

"arbitrary email message. That basic message model has a useful and flexible "

"API, but it provides only a lower-level API for interacting with the generic "

"parts of a message (the headers, generic header parameters, and the payload, "

"which may be a list of sub-parts). This module provides classes and tools "

"that provide an enhanced and extensible API for dealing with various "

"specific types of content, including the ability to retrieve the content of "

"the message as a specialized object type rather than as a simple bytes "

"object. The module automatically takes care of the RFC-specified MIME "

"details (required headers and parameters, etc.) for the certain common "

"content types content properties, and support for additional types can be "

"added by an application using the extension mechanisms."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:37

msgid ""

"This module defines the eponymous \"Content Manager\" classes. The base :"

"class:`.ContentManager` class defines an API for registering content "

"management functions which extract data from ``Message`` objects or insert "

"data and headers into ``Message`` objects, thus providing a way of "

"converting between ``Message`` objects containing data and other "

"representations of that data (Python data types, specialized Python objects, "

"external files, etc). The module also defines one concrete content "

"manager: :data:`raw_data_manager` converts between MIME content types and "

"``str`` or ``bytes`` data. It also provides a convenient API for managing "

"the MIME parameters when inserting content into ``Message``\\ s. It also "

"handles inserting and extracting ``Message`` objects when dealing with the "

"``message/rfc822`` content type."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:49

msgid ""

"Another part of the enhanced interface is subclasses of :class:`~email."

"message.Message` that provide new convenience API functions, including "

"convenience methods for calling the Content Managers derived from this "

"module."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:56

msgid ""

"Although :class:`.EmailMessage` and :class:`.MIMEPart` are currently "

"documented in this module because of the provisional nature of the code, the "

"implementation lives in the :mod:`email.message` module."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:64

msgid ""

"If *policy* is specified (it must be an instance of a :mod:`~email.policy` "

"class) use the rules it specifies to udpate and serialize the representation "

"of the message. If *policy* is not set, use the :class:`~email.policy."

"default` policy, which follows the rules of the email RFCs except for line "

"endings (instead of the RFC mandated ``\\r\\n``, it uses the Python standard "

"``\\n`` line endings). For more information see the :mod:`~email.policy` "

"documentation."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:72

msgid ""

"This class is a subclass of :class:`~email.message.Message`. It adds the "

"following methods:"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:78

msgid ""

"Return ``True`` if there is a :mailheader:`Content-Disposition` header and "

"its (case insensitive) value is ``attachment``, ``False`` otherwise."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:81

msgid ""

"is_attachment is now a method instead of a property, for consistency with :"

"meth:`~email.message.Message.is_multipart`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:88

msgid ""

"Return the MIME part that is the best candidate to be the \"body\" of the "

"message."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:91

msgid ""

"*preferencelist* must be a sequence of strings from the set ``related``, "

"``html``, and ``plain``, and indicates the order of preference for the "

"content type of the part returned."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:95

msgid ""

"Start looking for candidate matches with the object on which the "

"``get_body`` method is called."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:98

msgid ""

"If ``related`` is not included in *preferencelist*, consider the root part "

"(or subpart of the root part) of any related encountered as a candidate if "

"the (sub-)part matches a preference."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:102

msgid ""

"When encountering a ``multipart/related``, check the ``start`` parameter and "

"if a part with a matching :mailheader:`Content-ID` is found, consider only "

"it when looking for candidate matches. Otherwise consider only the first "

"(default root) part of the ``multipart/related``."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:107

msgid ""

"If a part has a :mailheader:`Content-Disposition` header, only consider the "

"part a candidate match if the value of the header is ``inline``."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:110

msgid ""

"If none of the candidates matches any of the preferences in *preferneclist*, "

"return ``None``."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:113

msgid ""

"Notes: (1) For most applications the only *preferencelist* combinations that "

"really make sense are ``('plain',)``, ``('html', 'plain')``, and the "

"default, ``('related', 'html', 'plain')``. (2) Because matching starts with "

"the object on which ``get_body`` is called, calling ``get_body`` on a "

"``multipart/related`` will return the object itself unless *preferencelist* "

"has a non-default value. (3) Messages (or message parts) that do not specify "

"a :mailheader:`Content-Type` or whose :mailheader:`Content-Type` header is "

"invalid will be treated as if they are of type ``text/plain``, which may "

"occasionally cause ``get_body`` to return unexpected results."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:127

msgid ""

"Return an iterator over all of the parts of the message that are not "

"candidate \"body\" parts. That is, skip the first occurrence of each of "

"``text/plain``, ``text/html``, ``multipart/related``, or ``multipart/"

"alternative`` (unless they are explicitly marked as attachments via :"

"mailheader:`Content-Disposition: attachment`), and return all remaining "

"parts. When applied directly to a ``multipart/related``, return an iterator "

"over the all the related parts except the root part (ie: the part pointed to "

"by the ``start`` parameter, or the first part if there is no ``start`` "

"parameter or the ``start`` parameter doesn't match the :mailheader:`Content-"

"ID` of any of the parts). When applied directly to a ``multipart/"

"alternative`` or a non-``multipart``, return an empty iterator."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:143

msgid ""

"Return an iterator over all of the immediate sub-parts of the message, which "

"will be empty for a non-``multipart``. (See also :meth:`~email.message."

"walk`.)"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:150

msgid ""

"Call the ``get_content`` method of the *content_manager*, passing self as "

"the message object, and passing along any other arguments or keywords as "

"additional arguments. If *content_manager* is not specified, use the "

"``content_manager`` specified by the current :mod:`~email.policy`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:158

msgid ""

"Call the ``set_content`` method of the *content_manager*, passing self as "

"the message object, and passing along any other arguments or keywords as "

"additional arguments. If *content_manager* is not specified, use the "

"``content_manager`` specified by the current :mod:`~email.policy`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:166

msgid ""

"Convert a non-``multipart`` message into a ``multipart/related`` message, "

"moving any existing :mailheader:`Content-` headers and payload into a (new) "

"first part of the ``multipart``. If *boundary* is specified, use it as the "

"boundary string in the multipart, otherwise leave the boundary to be "

"automatically created when it is needed (for example, when the message is "

"serialized)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:176

msgid ""

"Convert a non-``multipart`` or a ``multipart/related`` into a ``multipart/"

"alternative``, moving any existing :mailheader:`Content-` headers and "

"payload into a (new) first part of the ``multipart``. If *boundary* is "

"specified, use it as the boundary string in the multipart, otherwise leave "

"the boundary to be automatically created when it is needed (for example, "

"when the message is serialized)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:186

msgid ""

"Convert a non-``multipart``, a ``multipart/related``, or a ``multipart-"

"alternative`` into a ``multipart/mixed``, moving any existing :mailheader:"

"`Content-` headers and payload into a (new) first part of the "

"``multipart``. If *boundary* is specified, use it as the boundary string in "

"the multipart, otherwise leave the boundary to be automatically created when "

"it is needed (for example, when the message is serialized)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:196

msgid ""

"If the message is a ``multipart/related``, create a new message object, pass "

"all of the arguments to its :meth:`set_content` method, and :meth:`~email."

"message.Message.attach` it to the ``multipart``. If the message is a non-"

"``multipart``, call :meth:`make_related` and then proceed as above. If the "

"message is any other type of ``multipart``, raise a :exc:`TypeError`. If "

"*content_manager* is not specified, use the ``content_manager`` specified by "

"the current :mod:`~email.policy`. If the added part has no :mailheader:"

"`Content-Disposition` header, add one with the value ``inline``."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:209

msgid ""

"If the message is a ``multipart/alternative``, create a new message object, "

"pass all of the arguments to its :meth:`set_content` method, and :meth:"

"`~email.message.Message.attach` it to the ``multipart``. If the message is "

"a non-``multipart`` or ``multipart/related``, call :meth:`make_alternative` "

"and then proceed as above. If the message is any other type of "

"``multipart``, raise a :exc:`TypeError`. If *content_manager* is not "

"specified, use the ``content_manager`` specified by the current :mod:`~email."

"policy`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:221

msgid ""

"If the message is a ``multipart/mixed``, create a new message object, pass "

"all of the arguments to its :meth:`set_content` method, and :meth:`~email."

"message.Message.attach` it to the ``multipart``. If the message is a non-"

"``multipart``, ``multipart/related``, or ``multipart/alternative``, call :"

"meth:`make_mixed` and then proceed as above. If *content_manager* is not "

"specified, use the ``content_manager`` specified by the current :mod:`~email."

"policy`. If the added part has no :mailheader:`Content-Disposition` header, "

"add one with the value ``attachment``. This method can be used both for "

"explicit attachments (:mailheader:`Content-Disposition: attachment` and "

"``inline`` attachments (:mailheader:`Content-Disposition: inline`), by "

"passing appropriate options to the ``content_manager``."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:237

msgid "Remove the payload and all of the headers."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:242

msgid ""

"Remove the payload and all of the :exc:`Content-` headers, leaving all other "

"headers intact and in their original order."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:248

msgid ""

"This class represents a subpart of a MIME message. It is identical to :"

"class:`EmailMessage`, except that no :mailheader:`MIME-Version` headers are "

"added when :meth:`~EmailMessage.set_content` is called, since sub-parts do "

"not need their own :mailheader:`MIME-Version` headers."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:258

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 ""

#: ../Doc/library/email.contentmanager.rst:265

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 ""

#: ../Doc/library/email.contentmanager.rst:271

msgid ""

"To find the handler, look for the following keys in the registry, stopping "

"with the first one found:"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:274

msgid "the string representing the full MIME type (``maintype/subtype``)"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:275

msgid "the string representing the ``maintype``"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:276

msgid "the empty string"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:278

msgid ""

"If none of these keys produce a handler, raise a :exc:`KeyError` for the "

"full MIME type."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:284

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 ""

#: ../Doc/library/email.contentmanager.rst:293

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 ""

#: ../Doc/library/email.contentmanager.rst:297

msgid "the type itself (``typ``)"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:298

msgid ""

"the type's fully qualified name (``typ.__module__ + '.' + typ."

"__qualname__``)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:300

msgid "the type's qualname (``typ.__qualname__``)"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:301

msgid "the type's name (``typ.__name__``)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:303

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 ""

#: ../Doc/library/email.contentmanager.rst:309

msgid ""

"Also add a :mailheader:`MIME-Version` header if one is not present (see "

"also :class:`.MIMEPart`)."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:315

msgid ""

"Record the function *handler* as the handler for *key*. For the possible "

"values of *key*, see :meth:`get_content`."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:321

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 ""

#: ../Doc/library/email.contentmanager.rst:327

msgid "Content Manager Instances"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:329

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 ""

#: ../Doc/library/email.contentmanager.rst:338

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 ""

#: ../Doc/library/email.contentmanager.rst:350

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 ""

#: ../Doc/library/email.contentmanager.rst:372

msgid "Add headers and payload to *msg*:"

msgstr ""

#: ../Doc/library/email.contentmanager.rst:374

msgid ""

"Add a :mailheader:`Content-Type` header with a ``maintype/subtype`` value."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:377

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 ""

#: ../Doc/library/email.contentmanager.rst:379

msgid ""

"For ``bytes``, use the specified *maintype* and *subtype*, or raise a :exc:"

"`TypeError` if they are not specified."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:381

msgid ""

"For :class:`~email.message.Message` 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 ""

#: ../Doc/library/email.contentmanager.rst:386

msgid ""

"For *<'list'>*, which should be a list of :class:`~email.message.Message` "

"objects, set the ``maintype`` to ``multipart``, and the ``subtype`` to "

"*subtype* if it is specified, and ``mixed`` if it is not. If the message "

"parts in the *<'list'>* have :mailheader:`MIME-Version` headers, remove them."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:393

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 ""

#: ../Doc/library/email.contentmanager.rst:398

msgid ""

"If *cte* is set, encode the payload using the specified content transfer "

"encoding, and set the :mailheader:`Content-Transfer-Endcoding` header to "

"that value. For ``str`` objects, if it is not set use heuristics to "

"determine the most compact encoding. Possible values for *cte* are ``quoted-"

"printable``, ``base64``, ``7bit``, ``8bit``, and ``binary``. If the input "

"cannot be encoded in the specified encoding (eg: ``7bit``), raise a :exc:"

"`ValueError`. For :class:`~email.message.Message`, 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 ""

#: ../Doc/library/email.contentmanager.rst:411

msgid ""

"A *cte* of ``binary`` does not actually work correctly yet. The ``Message`` "

"object as modified by ``set_content`` is correct, but :class:`~email."

"generator.BytesGenerator` does not serialize it correctly."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:416

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 it 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 ""

#: ../Doc/library/email.contentmanager.rst:423

msgid ""

"If *filename* is specified, use it as the value of the ``filename`` "

"parameter of the :mailheader:`Content-Disposition` header. There is no "

"default."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:427

msgid ""

"If *cid* is specified, add a :mailheader:`Content-ID` header with *cid* as "

"its value."

msgstr ""

#: ../Doc/library/email.contentmanager.rst:430

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 ""

#: ../Doc/library/email.contentmanager.rst:434

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 ""