Документация Python неофициальный перевод

19.1.5. email.errors: Классы исключений и дефектовemail.errors: Exception and Defect classes

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

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

exception email.errors.MessageError

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

exception email.errors.MessageParseError

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

exception email.errors.HeaderParseError

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

exception email.errors.BoundaryError

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

exception email.errors.MultipartConversionError

Вызывается, когда к объекту Message добавляется полезная нагрузка с помощью add_payload(), но эта нагрузка уже является скаляром, а основной тип Content-Type сообщения не является ни multipart, ни отсутствующим. MultipartConversionError множественно наследуется от MessageError и встроенного TypeError.

Поскольку Message.add_payload() устарел, это исключение редко возникает на практике. Однако исключение также может возникнуть, если метод attach() вызывается для экземпляра класса, производного от MIMENonMultipart (например, MIMEImage).

Вот список дефектов, которые может обнаружить FeedParser при разборе сообщений. Обратите внимание, что дефекты добавляются в то сообщение, где была найдена проблема; например, если сообщение, вложенное в multipart/alternative, имеет некорректный заголовок, то у этого вложенного сообщения будет дефект, а у содержащих его сообщений – нет.

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

  • NoBoundaryInMultipartDefect – Сообщение, которое объявлено как multipart, но не имеет параметра boundary.

  • StartBoundaryNotFoundDefect – Начальная граница, объявленная в заголовке Content-Type, так и не была найдена.

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

    Новое в версии 3.3.

  • FirstHeaderLineIsContinuationDefect – У сообщения была строка продолжения в качестве первой строки заголовка.

  • MisplacedEnvelopeHeaderDefect – Во время разбора заголовка в середине блока заголовков обнаружен заголовок “Unix From”.

  • MissingHeaderBodySeparatorDefect – Во время разбора заголовков найдена строка без начального пробела, но и без символа ‘:’. Разбор продолжается в предположении, что эта строка представляет первую строку тела.

    Новое в версии 3.3.

  • MalformedHeaderDefect – Обнаружен заголовок, в котором отсутствовало двоеточие или который был искажён.

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

  • MultipartInvariantViolationDefect – сообщение, которое заявлено как multipart, но не содержит вложенных частей. Обратите внимание, что у сообщения с этим дефектом метод is_multipart() может возвращать false, даже если его тип содержимого заявлен как multipart.

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

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

  • InvalidBase64LengthDefect – При декодировании блока байтов в кодировке base64 количество недополнительных символов base64 было недопустимым (на 1 больше, чем кратно 4). Закодированный блок оставлен без изменений.