email.errors: 異常和缺陷類?

源代碼: Lib/email/errors.py

以下異常類在 email.errors 模塊中定義：

exception email.errors.MessageError?

這是 email 包可以引發(fā)的所有異常的基類。 它源自標準異常 Exception 類，這個類沒有定義其他方法。

exception email.errors.MessageParseError?

這是由 Parser 類引發(fā)的異常的基類。它派生自 MessageError。 headerregistry 使用的解析器也在內(nèi)部使用這個類。

exception email.errors.HeaderParseError?

在解析消息的 RFC 5322 標頭時，某些錯誤條件下會觸發(fā)，此類派生自 MessageParseError。 如果在調(diào)用方法時內(nèi)容類型未知，則 set_boundary() 方法將引發(fā)此錯誤。 當嘗試創(chuàng)建一個看起來包含嵌入式標頭的標頭時 Header 可能會針對某些 base64 解碼錯誤引發(fā)此錯誤（也就是說，應(yīng)該是一個 沒有前導(dǎo)空格并且看起來像標題的延續(xù)行）。

exception email.errors.BoundaryError?

已棄用和不再使用的。

exception email.errors.MultipartConversionError?

當使用 add_payload() 將有效負載添加到 Message 對象時，有效負載已經(jīng)是一個標量，而消息的 Content-Type 主類型不是 multipart 或者缺少時觸發(fā)該異常。 MultipartConversionError 多重繼承自 MessageError 和內(nèi)置的 TypeError。

由于 Message.add_payload() 已被棄用，此異常實際上極少會被引發(fā)。 但是如果在派生自 MIMENonMultipart 的類 (例如 MIMEImage) 的實例上調(diào)用 attach() 方法也可以引發(fā)此異常。

以下是 FeedParser 在解析消息時可發(fā)現(xiàn)的缺陷列表。 請注意這些缺陷會在問題被發(fā)現(xiàn)時加入到消息中，因此舉例來說，如果某條嵌套在 multipart/alternative 中的消息具有錯誤的標頭，該嵌套消息對象就會有一條缺陷，但外層消息對象則沒有。

所有缺陷類都是 email.errors.MessageDefect 的子類。

  • NoBoundaryInMultipartDefect -- 一條消息宣稱有多個部分，但卻沒有 boundary 形參。

  • StartBoundaryNotFoundDefect -- 在 Content-Type 標頭中宣稱的開始邊界無法被找到。

  • CloseBoundaryNotFoundDefect -- 找到了開始邊界，但相應(yīng)的結(jié)束邊界無法被找到。

    3.3 新版功能.

  • FirstHeaderLineIsContinuationDefect -- 消息以一個繼續(xù)行作為其第一個標頭行。

  • MisplacedEnvelopeHeaderDefect - 在標頭塊中間發(fā)現(xiàn)了一個 "Unix From" 標頭。

  • MissingHeaderBodySeparatorDefect - 在解析沒有前綴空格但又不包含 ':' 的標頭期間找到一行內(nèi)容。 解析將假定該行表示消息體的第一行以繼續(xù)執(zhí)行。

    3.3 新版功能.

  • MalformedHeaderDefect -- 找到一個缺失了冒號或格式錯誤的標頭。

    3.3 版后已移除: 此缺陷在近幾個 Python 版本中已不再使用。

  • MultipartInvariantViolationDefect -- 一條消息宣稱為 multipart，但無法找到任何子部分。 請注意當一條消息有此缺陷時，其 is_multipart() 方法可能返回 False，即使其內(nèi)容類型宣稱為 multipart。

  • InvalidBase64PaddingDefect -- 當解碼一個 base64 編碼的字節(jié)分塊時，填充的數(shù)據(jù)不正確。 雖然添加了足夠的填充數(shù)據(jù)以執(zhí)行解碼，但作為結(jié)果的已解碼字節(jié)串可能無效。

  • InvalidBase64CharactersDefect -- 當解碼一個 base64 編碼的字節(jié)分塊時，遇到了 base64 字符表以外的字符。 這些字符會被忽略，但作為結(jié)果的已解碼字節(jié)串可能無效。

  • InvalidBase64LengthDefect -- 當解碼一個 base64 編碼的字節(jié)分塊時，非填充 base64 字符的數(shù)量無效（比 4 的倍數(shù)多 1）。 已編碼分塊會保持原樣。

  • InvalidDateDefect -- 當解碼一個無效或不可解析的數(shù)據(jù)字段時引發(fā)。 原始值會被保持原樣。