email.contentmanager
：管理 MIME 内容
¶
源代码： Lib/email/contentmanager.py
3.6 版新增： 1
email.contentmanager.
ContentManager
¶
内容管理器的基类。提供标准注册机制注册的转换器介于 MIME 内容和其它表示，及
get_content
and
set_content
分派方法。
get_content
(
msg
,
*args
,
**kw
)
¶
查找处理程序函数基于
mimetype
of
msg
(见下一段落)，透过传递所有自变量调用它，并返回调用结果。预期处理程序会提取负载从
msg
并返回有关提取数据编码信息的对象。
要找到处理程序，在注册表中查找以下键，发现首个键时停止：
字符串表示完整 MIME 类型 (
maintype/subtype)字符串表示
maintype空字符串
若这些键未产生处理程序，引发
KeyError
对于完整 MIME 类型。
set_content
(
msg
,
obj
,
*args
,
**kw
)
¶
若
maintype
is
multipart
，引发
TypeError
; otherwise look up a handler function based on the type of
obj
(see next paragraph), call
clear_content()
在
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.
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:
类型本身 (
typ)类型的完全合格名称 (
typ.__module__ + '.' + typ.__qualname__).类型的 qualname (
typ.__qualname__)类型的名称 (
typ.__name__).
If none of the above match, repeat all of the checks above for each of the types in the
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
，引发
KeyError
for the fully qualified name of the type.
Also add a
MIME-Version
header if one is not present (see also
MIMEPart
).
add_get_handler
(
key
,
handler
)
¶
Record the function
handler
as the handler for
key
. For the possible values of
key
，见
get_content()
.
add_set_handler
(
typekey
,
handler
)
¶
Record
handler
as the function to call when an object of a type matching
typekey
会被传递给
set_content()
. For the possible values of
typekey
，见
set_content()
.
Currently the email package provides only one concrete content manager,
raw_data_manager
, although more may be added in the future.
raw_data_manager
是
content_manager
provided by
EmailPolicy
and its derivatives.
email.contentmanager.
raw_data_manager
¶
This content manager provides only a minimum interface beyond that provided by
Message
itself: it deals only with text, raw byte strings, and
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.
email.contentmanager.
get_content
(
msg
,
errors='replace'
)
¶
Return the payload of the part as either a string (for
text
parts), an
EmailMessage
object (for
message/rfc822
parts), or a
bytes
object (for all other non-multipart types). Raise a
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
.
email.contentmanager.
set_content
(
msg
,
<'str'>
,
subtype="plain"
,
charset='utf-8'
,
cte=None
,
disposition=None
,
filename=None
,
cid=None
,
params=None
,
headers=None
)
¶
email.contentmanager.
set_content
(
msg
,
<'bytes'>
,
maintype
,
subtype
,
cte="base64"
,
disposition=None
,
filename=None
,
cid=None
,
params=None
,
headers=None
)
email.contentmanager.
set_content
(
msg
,
<'EmailMessage'>
,
cte=None
,
disposition=None
,
filename=None
,
cid=None
,
params=None
,
headers=None
)
Add headers and payload to msg :
添加
Content-Type
头采用
maintype/subtype
值。
For
str，设置 MIMEmaintypetotext, and set the subtype to subtype if it is specified, orplainif it is not.For
bytes, use the specified maintype and subtype , or raise aTypeErrorif they are not specified.For
EmailMessageobjects, set the maintype tomessage, and set the subtype to subtype if it is specified orrfc822if it is not. If subtype ispartial，引发错误 (bytesobjects must be used to constructmessage/partialparts).
若
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.
若
cte
is set, encode the payload using the specified content transfer encoding, and set the
Content-Transfer-Encoding
header to that value. Possible values for
cte
are
quoted-printable
,
base64
,
7bit
,
8bit
，和
binary
. If the input cannot be encoded in the specified encoding (for example, specifying a
cte
of
7bit
for an input that contains non-ASCII values), raise a
ValueError
.
For
strobjects, if cte is not set use heuristics to determine the most compact encoding.For
EmailMessage, per RFC 2046 , raise an error if a cte ofquoted-printableorbase64is requested for subtyperfc822, and for any cte 除了7bitfor subtypeexternal-body. Formessage/rfc822，使用8bitif cte is not specified. For all other values of subtype ，使用7bit.
注意
A
cte
of
binary
does not actually work correctly yet.
EmailMessage
object as modified by
set_content
is correct, but
BytesGenerator
does not serialize it correctly.
若
disposition
is set, use it as the value of the
Content-Disposition
header. If not specified, and
filename
is specified, add the header with the value
attachment
。若
disposition
is not specified and
filename
is also not specified, do not add the header. The only valid values for
disposition
are
attachment
and
inline
.
若
filename
is specified, use it as the value of the
filename
parameter of the
Content-Disposition
头。
若 cid is specified, add a Content-ID header with cid as its value.
若
params
is specified, iterate its
items
method and use the resulting
(key, value)
pairs to set additional parameters on the
Content-Type
头。
若
headers
is specified and is a list of strings of the form
headername: headervalue
或列表对于
header
objects (distinguished from strings by having a
name
attribute), add the headers to
msg
.
脚注