# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/email.message.rst:2 msgid ":mod:`email.message`: Representing an email message" msgstr "" #: ../Doc/library/email.message.rst:8 msgid "" "The central class in the :mod:`email` package is the :class:`Message` class, " "imported from the :mod:`email.message` module. It is the base class for " "the :mod:`email` object model. :class:`Message` provides the core " "functionality for setting and querying header fields, and for accessing " "message bodies." msgstr "" #: ../Doc/library/email.message.rst:13 msgid "" "Conceptually, a :class:`Message` object consists of *headers* and " "*payloads*. Headers are :rfc:`2822` style field names and values where the " "field name and value are separated by a colon. The colon is not part of " "either the field name or the field value." msgstr "" #: ../Doc/library/email.message.rst:18 msgid "" "Headers are stored and returned in case-preserving form but are matched case-" "insensitively. There may also be a single envelope header, also known as " "the *Unix-From* header or the ``From_`` header. The payload is either a " "string in the case of simple message objects or a list of :class:`Message` " "objects for MIME container documents (e.g. :mimetype:`multipart/\\*` and :" "mimetype:`message/rfc822`)." msgstr "" #: ../Doc/library/email.message.rst:25 msgid "" ":class:`Message` objects provide a mapping style interface for accessing the " "message headers, and an explicit interface for accessing both the headers " "and the payload. It provides convenience methods for generating a flat text " "representation of the message object tree, for accessing commonly used " "header parameters, and for recursively walking over the object tree." msgstr "" #: ../Doc/library/email.message.rst:31 msgid "Here are the methods of the :class:`Message` class:" msgstr "" #: ../Doc/library/email.message.rst:36 msgid "The constructor takes no arguments." msgstr "" #: ../Doc/library/email.message.rst:41 msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is ``True``, the envelope header is included in the returned string. " "*unixfrom* defaults to ``False``. Flattening the message may trigger " "changes to the :class:`Message` if defaults need to be filled in to complete " "the transformation to a string (for example, MIME boundaries may be " "generated or modified)." msgstr "" #: ../Doc/library/email.message.rst:48 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it mangles lines that " "begin with ``From``. For more flexibility, instantiate a :class:`~email." "generator.Generator` instance and use its :meth:`~email.generator.Generator." "flatten` method directly. For example::" msgstr "" #: ../Doc/library/email.message.rst:64 msgid "Equivalent to ``as_string(unixfrom=True)``." msgstr "" #: ../Doc/library/email.message.rst:69 msgid "" "Return ``True`` if the message's payload is a list of sub-\\ :class:" "`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " "returns ``False``, the payload should be a string object." msgstr "" #: ../Doc/library/email.message.rst:76 msgid "" "Set the message's envelope header to *unixfrom*, which should be a string." msgstr "" #: ../Doc/library/email.message.rst:81 msgid "" "Return the message's envelope header. Defaults to ``None`` if the envelope " "header was never set." msgstr "" #: ../Doc/library/email.message.rst:87 msgid "" "Add the given *payload* to the current payload, which must be ``None`` or a " "list of :class:`Message` objects before the call. After the call, the " "payload will always be a list of :class:`Message` objects. If you want to " "set the payload to a scalar object (e.g. a string), use :meth:`set_payload` " "instead." msgstr "" #: ../Doc/library/email.message.rst:96 msgid "" "Return the current payload, which will be a list of :class:`Message` objects " "when :meth:`is_multipart` is ``True``, or a string when :meth:`is_multipart` " "is ``False``. If the payload is a list and you mutate the list object, you " "modify the message's payload in place." msgstr "" #: ../Doc/library/email.message.rst:101 msgid "" "With optional argument *i*, :meth:`get_payload` will return the *i*-th " "element of the payload, counting from zero, if :meth:`is_multipart` is " "``True``. An :exc:`IndexError` will be raised if *i* is less than 0 or " "greater than or equal to the number of items in the payload. If the payload " "is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, a :" "exc:`TypeError` is raised." msgstr "" #: ../Doc/library/email.message.rst:108 msgid "" "Optional *decode* is a flag indicating whether the payload should be decoded " "or not, according to the :mailheader:`Content-Transfer-Encoding` header. " "When ``True`` and the message is not a multipart, the payload will be " "decoded if this header's value is ``quoted-printable`` or ``base64``. If " "some other encoding is used, or :mailheader:`Content-Transfer-Encoding` " "header is missing, or if the payload has bogus base64 data, the payload is " "returned as-is (undecoded). If the message is a multipart and the *decode* " "flag is ``True``, then ``None`` is returned. The default for *decode* is " "``False``." msgstr "" #: ../Doc/library/email.message.rst:121 msgid "" "Set the entire message object's payload to *payload*. It is the client's " "responsibility to ensure the payload invariants. Optional *charset* sets " "the message's default character set; see :meth:`set_charset` for details." msgstr "" #: ../Doc/library/email.message.rst:125 msgid "*charset* argument added." msgstr "" #: ../Doc/library/email.message.rst:131 msgid "" "Set the character set of the payload to *charset*, which can either be a :" "class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string " "naming a character set, or ``None``. If it is a string, it will be " "converted to a :class:`~email.charset.Charset` instance. If *charset* is " "``None``, the ``charset`` parameter will be removed from the :mailheader:" "`Content-Type` header (the message will not be otherwise modified). " "Anything else will generate a :exc:`TypeError`." msgstr "" #: ../Doc/library/email.message.rst:139 msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " "be added with a value of :mimetype:`text/plain`. Whether the :mailheader:" "`Content-Type` header already exists or not, its ``charset`` parameter will " "be set to *charset.output_charset*. If *charset.input_charset* and " "*charset.output_charset* differ, the payload will be re-encoded to the " "*output_charset*. If there is no existing :mailheader:`Content-Transfer-" "Encoding` header, then the payload will be transfer-encoded, if needed, " "using the specified :class:`~email.charset.Charset`, and a header with the " "appropriate value will be added. If a :mailheader:`Content-Transfer-" "Encoding` header already exists, the payload is assumed to already be " "correctly encoded using that :mailheader:`Content-Transfer-Encoding` and is " "not modified." msgstr "" #: ../Doc/library/email.message.rst:153 msgid "" "The message will be assumed to be of type :mimetype:`text/\\*`, with the " "payload either in unicode or encoded with *charset.input_charset*. It will " "be encoded or converted to *charset.output_charset* and transfer encoded " "properly, if needed, when generating the plain text representation of the " "message. MIME headers (:mailheader:`MIME-Version`, :mailheader:`Content-" "Type`, :mailheader:`Content-Transfer-Encoding`) will be added as needed." msgstr "" #: ../Doc/library/email.message.rst:166 msgid "" "Return the :class:`~email.charset.Charset` instance associated with the " "message's payload." msgstr "" #: ../Doc/library/email.message.rst:171 msgid "" "The following methods implement a mapping-like interface for accessing the " "message's :rfc:`2822` headers. Note that there are some semantic " "differences between these methods and a normal mapping (i.e. dictionary) " "interface. For example, in a dictionary there are no duplicate keys, but " "here there may be duplicate message headers. Also, in dictionaries there is " "no guaranteed order to the keys returned by :meth:`keys`, but in a :class:" "`Message` object, headers are always returned in the order they appeared in " "the original message, or were added to the message later. Any header " "deleted and then re-added are always appended to the end of the header list." msgstr "" #: ../Doc/library/email.message.rst:181 msgid "" "These semantic differences are intentional and are biased toward maximal " "convenience." msgstr "" #: ../Doc/library/email.message.rst:184 msgid "" "Note that in all cases, any envelope header present in the message is not " "included in the mapping interface." msgstr "" #: ../Doc/library/email.message.rst:190 msgid "Return the total number of headers, including duplicates." msgstr "" #: ../Doc/library/email.message.rst:195 msgid "" "Return true if the message object has a field named *name*. Matching is done " "case-insensitively and *name* should not include the trailing colon. Used " "for the ``in`` operator, e.g.::" msgstr "" #: ../Doc/library/email.message.rst:205 msgid "" "Return the value of the named header field. *name* should not include the " "colon field separator. If the header is missing, ``None`` is returned; a :" "exc:`KeyError` is never raised." msgstr "" #: ../Doc/library/email.message.rst:209 msgid "" "Note that if the named field appears more than once in the message's " "headers, exactly which of those field values will be returned is undefined. " "Use the :meth:`get_all` method to get the values of all the extant named " "headers." msgstr "" #: ../Doc/library/email.message.rst:217 msgid "" "Add a header to the message with field name *name* and value *val*. The " "field is appended to the end of the message's existing fields." msgstr "" #: ../Doc/library/email.message.rst:220 msgid "" "Note that this does *not* overwrite or delete any existing header with the " "same name. If you want to ensure that the new header is the only one " "present in the message with field name *name*, delete the field first, e.g.::" msgstr "" #: ../Doc/library/email.message.rst:230 msgid "" "Delete all occurrences of the field with name *name* from the message's " "headers. No exception is raised if the named field isn't present in the " "headers." msgstr "" #: ../Doc/library/email.message.rst:236 msgid "" "Return true if the message contains a header field named *name*, otherwise " "return false." msgstr "" #: ../Doc/library/email.message.rst:242 msgid "Return a list of all the message's header field names." msgstr "" #: ../Doc/library/email.message.rst:247 msgid "Return a list of all the message's field values." msgstr "" #: ../Doc/library/email.message.rst:252 msgid "" "Return a list of 2-tuples containing all the message's field headers and " "values." msgstr "" #: ../Doc/library/email.message.rst:258 msgid "" "Return the value of the named header field. This is identical to :meth:" "`__getitem__` except that optional *failobj* is returned if the named header " "is missing (defaults to ``None``)." msgstr "" #: ../Doc/library/email.message.rst:262 msgid "Here are some additional useful methods:" msgstr "" #: ../Doc/library/email.message.rst:267 msgid "" "Return a list of all the values for the field named *name*. If there are no " "such named headers in the message, *failobj* is returned (defaults to " "``None``)." msgstr "" #: ../Doc/library/email.message.rst:274 msgid "" "Extended header setting. This method is similar to :meth:`__setitem__` " "except that additional header parameters can be provided as keyword " "arguments. *_name* is the header field to add and *_value* is the *primary* " "value for the header." msgstr "" #: ../Doc/library/email.message.rst:279 msgid "" "For each item in the keyword argument dictionary *_params*, the key is taken " "as the parameter name, with underscores converted to dashes (since dashes " "are illegal in Python identifiers). Normally, the parameter will be added " "as ``key=\"value\"`` unless the value is ``None``, in which case only the " "key will be added. If the value contains non-ASCII characters, it must be " "specified as a three tuple in the format ``(CHARSET, LANGUAGE, VALUE)``, " "where ``CHARSET`` is a string naming the charset to be used to encode the " "value, ``LANGUAGE`` can usually be set to ``None`` or the empty string (see :" "RFC:`2231` for other possibilities), and ``VALUE`` is the string value " "containing non-ASCII code points." msgstr "" #: ../Doc/library/email.message.rst:290 msgid "Here's an example::" msgstr "" #: ../Doc/library/email.message.rst:294 msgid "This will add a header that looks like ::" msgstr "" #: ../Doc/library/email.message.rst:298 msgid "An example with non-ASCII characters::" msgstr "" #: ../Doc/library/email.message.rst:303 msgid "Which produces ::" msgstr "" #: ../Doc/library/email.message.rst:310 msgid "" "Replace a header. Replace the first header found in the message that " "matches *_name*, retaining header order and field name case. If no matching " "header was found, a :exc:`KeyError` is raised." msgstr "" #: ../Doc/library/email.message.rst:319 msgid "" "Return the message's content type. The returned string is coerced to lower " "case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" "`Content-Type` header in the message the default type as given by :meth:" "`get_default_type` will be returned. Since according to :rfc:`2045`, " "messages always have a default type, :meth:`get_content_type` will always " "return a value." msgstr "" #: ../Doc/library/email.message.rst:326 msgid "" ":rfc:`2045` defines a message's default type to be :mimetype:`text/plain` " "unless it appears inside a :mimetype:`multipart/digest` container, in which " "case it would be :mimetype:`message/rfc822`. If the :mailheader:`Content-" "Type` header has an invalid type specification, :rfc:`2045` mandates that " "the default type be :mimetype:`text/plain`." msgstr "" #: ../Doc/library/email.message.rst:337 msgid "" "Return the message's main content type. This is the :mimetype:`maintype` " "part of the string returned by :meth:`get_content_type`." msgstr "" #: ../Doc/library/email.message.rst:345 msgid "" "Return the message's sub-content type. This is the :mimetype:`subtype` part " "of the string returned by :meth:`get_content_type`." msgstr "" #: ../Doc/library/email.message.rst:353 msgid "" "Return the default content type. Most messages have a default content type " "of :mimetype:`text/plain`, except for messages that are subparts of :" "mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" #: ../Doc/library/email.message.rst:363 msgid "" "Set the default content type. *ctype* should either be :mimetype:`text/" "plain` or :mimetype:`message/rfc822`, although this is not enforced. The " "default content type is not stored in the :mailheader:`Content-Type` header." msgstr "" #: ../Doc/library/email.message.rst:373 msgid "" "Return the message's :mailheader:`Content-Type` parameters, as a list. The " "elements of the returned list are 2-tuples of key/value pairs, as split on " "the ``'='`` sign. The left hand side of the ``'='`` is the key, while the " "right hand side is the value. If there is no ``'='`` sign in the parameter " "the value is the empty string, otherwise the value is as described in :meth:" "`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." msgstr "" #: ../Doc/library/email.message.rst:381 msgid "" "Optional *failobj* is the object to return if there is no :mailheader:" "`Content-Type` header. Optional *header* is the header to search instead " "of :mailheader:`Content-Type`." msgstr "" #: ../Doc/library/email.message.rst:385 msgid "*unquote* argument added." msgstr "" #: ../Doc/library/email.message.rst:391 msgid "" "Return the value of the :mailheader:`Content-Type` header's parameter " "*param* as a string. If the message has no :mailheader:`Content-Type` " "header or if there is no such parameter, then *failobj* is returned " "(defaults to ``None``)." msgstr "" #: ../Doc/library/email.message.rst:396 msgid "" "Optional *header* if given, specifies the message header to use instead of :" "mailheader:`Content-Type`." msgstr "" #: ../Doc/library/email.message.rst:399 msgid "" "Parameter keys are always compared case insensitively. The return value can " "either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. " "When it's a 3-tuple, the elements of the value are of the form ``(CHARSET, " "LANGUAGE, VALUE)``. Note that both ``CHARSET`` and ``LANGUAGE`` can be " "``None``, in which case you should consider ``VALUE`` to be encoded in the " "``us-ascii`` charset. You can usually ignore ``LANGUAGE``." msgstr "" #: ../Doc/library/email.message.rst:407 msgid "" "If your application doesn't care whether the parameter was encoded as in :" "rfc:`2231`, you can collapse the parameter value by calling :func:`email." "utils.collapse_rfc2231_value`, passing in the return value from :meth:" "`get_param`. This will return a suitably decoded Unicode string when the " "value is a tuple, or the original string unquoted if it isn't. For example::" msgstr "" #: ../Doc/library/email.message.rst:417 msgid "" "In any case, the parameter value (either the returned string, or the " "``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " "to ``False``." msgstr "" #: ../Doc/library/email.message.rst:421 msgid "*unquote* argument added, and 3-tuple return value possible." msgstr "" #: ../Doc/library/email.message.rst:427 msgid "" "Set a parameter in the :mailheader:`Content-Type` header. If the parameter " "already exists in the header, its value will be replaced with *value*. If " "the :mailheader:`Content-Type` header as not yet been defined for this " "message, it will be set to :mimetype:`text/plain` and the new parameter " "value will be appended as per :rfc:`2045`." msgstr "" #: ../Doc/library/email.message.rst:433 msgid "" "Optional *header* specifies an alternative header to :mailheader:`Content-" "Type`, and all parameters will be quoted as necessary unless optional " "*requote* is ``False`` (the default is ``True``)." msgstr "" #: ../Doc/library/email.message.rst:437 msgid "" "If optional *charset* is specified, the parameter will be encoded according " "to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, " "defaulting to the empty string. Both *charset* and *language* should be " "strings." msgstr "" #: ../Doc/library/email.message.rst:447 msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " "value. All values will be quoted as necessary unless *requote* is ``False`` " "(the default is ``True``). Optional *header* specifies an alternative to :" "mailheader:`Content-Type`." msgstr "" #: ../Doc/library/email.message.rst:458 msgid "" "Set the main type and subtype for the :mailheader:`Content-Type` header. " "*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " "a :exc:`ValueError` is raised." msgstr "" #: ../Doc/library/email.message.rst:462 msgid "" "This method replaces the :mailheader:`Content-Type` header, keeping all the " "parameters in place. If *requote* is ``False``, this leaves the existing " "header's quoting as is, otherwise the parameters will be quoted (the " "default)." msgstr "" #: ../Doc/library/email.message.rst:467 msgid "" "An alternative header can be specified in the *header* argument. When the :" "mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " "is also added." msgstr "" #: ../Doc/library/email.message.rst:476 msgid "" "Return the value of the ``filename`` parameter of the :mailheader:`Content-" "Disposition` header of the message. If the header does not have a " "``filename`` parameter, this method falls back to looking for the ``name`` " "parameter on the :mailheader:`Content-Type` header. If neither is found, or " "the header is missing, then *failobj* is returned. The returned string will " "always be unquoted as per :func:`email.utils.unquote`." msgstr "" #: ../Doc/library/email.message.rst:487 msgid "" "Return the value of the ``boundary`` parameter of the :mailheader:`Content-" "Type` header of the message, or *failobj* if either the header is missing, " "or has no ``boundary`` parameter. The returned string will always be " "unquoted as per :func:`email.utils.unquote`." msgstr "" #: ../Doc/library/email.message.rst:495 msgid "" "Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to " "*boundary*. :meth:`set_boundary` will always quote *boundary* if " "necessary. A :exc:`~email.errors.HeaderParseError` is raised if the message " "object has no :mailheader:`Content-Type` header." msgstr "" #: ../Doc/library/email.message.rst:500 msgid "" "Note that using this method is subtly different than deleting the old :" "mailheader:`Content-Type` header and adding a new one with the new boundary " "via :meth:`add_header`, because :meth:`set_boundary` preserves the order of " "the :mailheader:`Content-Type` header in the list of headers. However, it " "does *not* preserve any continuation lines which may have been present in " "the original :mailheader:`Content-Type` header." msgstr "" #: ../Doc/library/email.message.rst:510 msgid "" "Return the ``charset`` parameter of the :mailheader:`Content-Type` header, " "coerced to lower case. If there is no :mailheader:`Content-Type` header, or " "if that header has no ``charset`` parameter, *failobj* is returned." msgstr "" #: ../Doc/library/email.message.rst:514 msgid "" "Note that this method differs from :meth:`get_charset` which returns the :" "class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" #: ../Doc/library/email.message.rst:522 msgid "" "Return a list containing the character set names in the message. If the " "message is a :mimetype:`multipart`, then the list will contain one element " "for each subpart in the payload, otherwise, it will be a list of length 1." msgstr "" #: ../Doc/library/email.message.rst:526 msgid "" "Each item in the list will be a string which is the value of the ``charset`` " "parameter in the :mailheader:`Content-Type` header for the represented " "subpart. However, if the subpart has no :mailheader:`Content-Type` header, " "no ``charset`` parameter, or is not of the :mimetype:`text` main MIME type, " "then that item in the returned list will be *failobj*." msgstr "" #: ../Doc/library/email.message.rst:536 msgid "" "The :meth:`walk` method is an all-purpose generator which can be used to " "iterate over all the parts and subparts of a message object tree, in depth-" "first traversal order. You will typically use :meth:`walk` as the iterator " "in a ``for`` loop; each iteration returns the next subpart." msgstr "" #: ../Doc/library/email.message.rst:541 msgid "" "Here's an example that prints the MIME type of every part of a multipart " "message structure::" msgstr "" #: ../Doc/library/email.message.rst:553 msgid "" "The previously deprecated methods :meth:`get_type`, :meth:`get_main_type`, " "and :meth:`get_subtype` were removed." msgstr "" #: ../Doc/library/email.message.rst:557 msgid "" ":class:`Message` objects can also optionally contain two instance " "attributes, which can be used when generating the plain text of a MIME " "message." msgstr "" #: ../Doc/library/email.message.rst:563 msgid "" "The format of a MIME document allows for some text between the blank line " "following the headers, and the first multipart boundary string. Normally, " "this text is never visible in a MIME-aware mail reader because it falls " "outside the standard MIME armor. However, when viewing the raw text of the " "message, or when viewing the message in a non-MIME aware reader, this text " "can become visible." msgstr "" #: ../Doc/library/email.message.rst:570 msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " "the headers but before the first boundary string, it assigns this text to " "the message's *preamble* attribute. When the :class:`~email.generator." "Generator` is writing out the plain text representation of a MIME message, " "and it finds the message has a *preamble* attribute, it will write this text " "in the area between the headers and the first boundary. See :mod:`email." "parser` and :mod:`email.generator` for details." msgstr "" #: ../Doc/library/email.message.rst:580 msgid "" "Note that if the message object has no preamble, the *preamble* attribute " "will be ``None``." msgstr "" #: ../Doc/library/email.message.rst:586 msgid "" "The *epilogue* attribute acts the same way as the *preamble* attribute, " "except that it contains text that appears between the last boundary and the " "end of the message." msgstr "" #: ../Doc/library/email.message.rst:590 msgid "" "You do not need to set the epilogue to the empty string in order for the :" "class:`~email.generator.Generator` to print a newline at the end of the file." msgstr "" #: ../Doc/library/email.message.rst:598 msgid "" "The *defects* attribute contains a list of all the problems found when " "parsing this message. See :mod:`email.errors` for a detailed description of " "the possible parsing defects." msgstr ""