12.2.1.1 Deprecated methods

The following methods are deprecated in email version 2. They are documented here for completeness.

add_payload(payload)

Add payload to the message object's existing payload. If, prior to calling this method, the object's payload was None (i.e. never before set), then after this method is called, the payload will be the argument payload.

If the object's payload was already a list (i.e. is_multipart() returns 1), then payload is appended to the end of the existing payload list.

For any other type of existing payload, add_payload() will transform the new payload into a list consisting of the old payload and payload, but only if the document is already a MIME multipart document. This condition is satisfied if the message's Content-Type: header's main type is either multipart, or there is no Content-Type: header. In any other situation, MultipartConversionError is raised.

Deprecated since release 2.2.2. Use the attach() method instead.

get_type([failobj])

Return the message's content type, as a string of the form maintype/subtype as taken from the Content-Type: header. The returned string is coerced to lowercase.

If there is no Content-Type: header in the message, failobj is returned (defaults to None).

Deprecated since release 2.2.2. Use the get_content_type() method instead.

get_main_type([failobj])

Return the message's main content type. This essentially returns the maintype part of the string returned by get_type(), with the same semantics for failobj.

Deprecated since release 2.2.2. Use the get_content_maintype() method instead.

get_subtype([failobj])

Return the message's sub-content type. This essentially returns the subtype part of the string returned by get_type(), with the same semantics for failobj.

Deprecated since release 2.2.2. Use the get_content_subtype() method instead.

See About this document... for information on suggesting changes.