email.errors: классы исключений и дефектов

Исходный код: Lib/email/errors.py

В модуле email.errors определены следующие классы исключений:

exception email.errors.MessageError

Это базовый класс для всех исключений, которые может вызывать пакет email. Он является производным от стандартного класса Exception и не определяет дополнительных методов.

exception email.errors.MessageParseError

Это базовый класс для исключений, вызываемых классом Parser. Он является производным от MessageError. Этот класс также используется внутри парсера, применяемого модулем headerregistry.

exception email.errors.HeaderParseError

Этот класс, являющийся производным от MessageParseError, вызывается при некоторых ошибках во время разбора заголовков сообщения в формате RFC 5322. Метод set_boundary() вызывает эту ошибку, если на момент вызова метода тип содержимого неизвестен. Header может вызвать эту ошибку при некоторых ошибках декодирования base64, а также при попытке создать заголовок, который, по всей видимости, содержит вложенный заголовок (то есть строка, предположительно являющаяся строкой продолжения, не начинается с пробельных символов и похожа на заголовок).

exception email.errors.BoundaryError

Устарел и больше не используется.

exception email.errors.MultipartConversionError

Вызывается, если метод attach() вызывается для экземпляра класса, производного от MIMENonMultipart (например, MIMEImage). MultipartConversionError наследуется одновременно от MessageError и встроенного класса TypeError.

exception email.errors.HeaderWriteError

Вызывается при возникновении ошибки во время вывода заголовков модулем generator.

exception email.errors.MessageDefect

Это базовый класс для всех дефектов, обнаруженных при разборе сообщений электронной почты. Он является производным от ValueError.

exception email.errors.HeaderDefect

Это базовый класс для всех дефектов, обнаруженных при разборе заголовков электронной почты. Он является производным от MessageDefect.

Ниже приведён список дефектов, которые FeedParser может обнаружить при разборе сообщений. Обратите внимание: дефекты добавляются в то сообщение, в котором обнаружена проблема. Например, если сообщение, вложенное в multipart/alternative, содержит некорректный заголовок, дефект будет добавлен к объекту этого вложенного сообщения, но не к содержащим его сообщениям.

Все классы дефектов являются подклассами email.errors.MessageDefect.

exception email.errors.NoBoundaryInMultipartDefect

Сообщение объявлено составным, но параметр boundary отсутствует.

exception email.errors.StartBoundaryNotFoundDefect

Не удалось найти начальную границу, указанную в заголовке Content-Type.

exception email.errors.CloseBoundaryNotFoundDefect

Начальная граница найдена, но соответствующая конечная граница так и не была найдена.

Добавлено в версии 3.3.

exception email.errors.FirstHeaderLineIsContinuationDefect

Первая строка заголовка сообщения является строкой продолжения.

exception email.errors.MisplacedEnvelopeHeaderDefect

В середине блока заголовков найден заголовок «Unix From».

exception email.errors.MissingHeaderBodySeparatorDefect

При разборе заголовков найдена строка без начальных пробельных символов, в которой отсутствует символ «:». Разбор продолжается в предположении, что эта строка является первой строкой тела сообщения.

Добавлено в версии 3.3.

exception email.errors.MalformedHeaderDefect

Обнаружен заголовок без двоеточия или иным образом имеющий некорректный формат.

Устарело с версии 3.3: Этот дефект не использовался в течение нескольких версий Python.

exception email.errors.MultipartInvariantViolationDefect

Сообщение объявлено как multipart, но вложенные части не найдены. Обратите внимание: если у сообщения есть этот дефект, его метод is_multipart() может возвращать False, несмотря на то что тип его содержимого указывает на multipart.

exception email.errors.InvalidBase64PaddingDefect

При декодировании блока байтов, закодированных в base64, обнаружено неверное заполнение. Для выполнения декодирования добавляется достаточное заполнение, однако полученные декодированные байты могут быть недопустимыми.

exception email.errors.InvalidBase64CharactersDefect

При декодировании блока байтов, закодированных в base64, обнаружены символы, не входящие в алфавит base64. Эти символы игнорируются, однако полученные декодированные байты могут быть недопустимыми.

exception email.errors.InvalidBase64LengthDefect

При декодировании блока байтов, закодированных в base64, обнаружено недопустимое количество символов base64 без заполнения (на один больше, чем кратное четырём). Закодированный блок оставлен без изменений.

exception email.errors.InvalidDateDefect

Обнаружено некорректное или не поддающееся разбору поле даты. Исходное значение оставлено без изменений.