email
— Email 和 MIME 处理包
»
email.errors
：异常和缺陷类
¶
源代码： Lib/email/errors.py
下列异常类的定义在
email.errors
模块：
email.errors.
MessageParseError
¶
这异常基类引发通过
Parser
类。派生自
MessageError
.
email.errors.
HeaderParseError
¶
Raised under some error conditions when parsing the
RFC 2822
headers of a message, this class is derived from
MessageParseError
. It can be raised from the
Parser.parse
or
Parser.parsestr
方法。
Situations where it can be raised include finding an envelope header after the first RFC 2822 header of the message, finding a continuation line before the first RFC 2822 header is found, or finding a line in the headers which is neither a header or a continuation line.
email.errors.
BoundaryError
¶
Raised under some error conditions when parsing the
RFC 2822
headers of a message, this class is derived from
MessageParseError
. It can be raised from the
Parser.parse
or
Parser.parsestr
方法。
Situations where it can be raised include not being able to find the starting or terminating boundary in a multipart/* message when strict parsing is used.
email.errors.
MultipartConversionError
¶
被引发当将负载添加到
Message
对象使用
add_payload()
, but the payload is already a scalar and the message’s
Content-Type
main type is not either
multipart
or missing.
MultipartConversionError
multiply inherits from
MessageError
和内置
TypeError
.
由于
Message.add_payload()
is deprecated, this exception is rarely raised in practice. However the exception may also be raised if the
attach()
method is called on an instance of a class derived from
MIMENonMultipart
(如
MIMEImage
).
Here’s the list of the defects that the
FeedParser
can find while parsing messages. Note that the defects are added to the message where the problem was found, so for example, if a message nested inside a
multipart/alternative
had a malformed header, that nested message object would have a defect, but the containing messages would not.
所有子类化的缺陷类来自
email.errors.MessageDefect
, but this class is
not
an exception!
NoBoundaryInMultipartDefect
– A message claimed to be a multipart, but had no
boundary
参数。
StartBoundaryNotFoundDefect
– The start boundary claimed in the
Content-Type
header was never found.
CloseBoundaryNotFoundDefect
– A start boundary was found, but no corresponding close boundary was ever found.
3.3 版新增。
FirstHeaderLineIsContinuationDefect
– The message had a continuation line as its first header line.
MisplacedEnvelopeHeaderDefect
- A “Unix From” header was found in the middle of a header block.
MissingHeaderBodySeparatorDefect
- A line was found while parsing headers that had no leading white space but contained no ‘:’. Parsing continues assuming that the line represents the first line of the body.
3.3 版新增。
MalformedHeaderDefect
– A header was found that was missing a colon, or was otherwise malformed.
从 3.3 版起弃用： 此缺陷尚未用于多个 Python 版本。
MultipartInvariantViolationDefect
– A message claimed to be a
multipart
, but no subparts were found. Note that when a message has this defect, its
is_multipart()
method may return false even though its content type claims to be
multipart
.
InvalidBase64PaddingDefect
– When decoding a block of base64 encoded bytes, the padding was not correct. Enough padding is added to perform the decode, but the resulting decoded bytes may be invalid.
InvalidBase64CharactersDefect
– When decoding a block of base64 encoded bytes, characters outside the base64 alphabet were encountered. The characters are ignored, but the resulting decoded bytes may be invalid.