mimetools — Инструменты для разбора сообщений MIME

В этом модуле определён подкласс класса rfc822 Message и ряд служебных функций, полезных для работы с сообщениями MIME multipart или закодированными сообщениями.

Он определяет следующие элементы:

class mimetools.Message(fp[, seekable])

Возвращает новый экземпляр класса Message. Это подкласс класса rfc822.Message с некоторыми дополнительными методами (см. ниже). Аргумент seekable имеет то же значение, что и для rfc822.Message.

mimetools.choose_boundary()

Возвращает уникальную строку, с высокой вероятностью пригодную в качестве границы части. Строка имеет вид 'hostipaddr.uid.pid.timestamp.random'.

mimetools.decode(input, output, encoding)

Считывает данные, закодированные с помощью допустимого кодирования MIME encoding из открытого файла input и записывает декодированные данные в открытый файл output. Допустимые значения для encoding включают 'base64', 'quoted-printable', 'uuencode', 'x-uuencode', 'uue', 'x-uue', '7bit', и '8bit'. Декодирование сообщений, закодированных в '7bit' или '8bit', не оказывает влияния. Вход просто копируется на выход.

mimetools.encode(input, output, encoding)

Считывает данные из открытого файла input и записывает их, закодированные с помощью допустимого кодирования MIME encoding, в открытый файл output. Допустимые значения для encoding такие же, как и для decode().

mimetools.copyliteral(input, output)

Считывает строки из открытого файла input до конца файла и записывает их в открытый файл output.

mimetools.copybinary(input, output)

Считывает блоки до конца файла из открытого файла input и записывает их в открытый файл output. Размер блока в настоящее время фиксирован и равен 8192.

1. Дополнительные методы объектов Message

Класс Message определяет следующие методы дополнительно к методам rfc822.Message:

Message.getplist()

Возвращает список параметров заголовка Content-Type. Это список строк. Для параметров вида key=value, key преобразуется в нижний регистр, но value нет. Например, если сообщение содержит заголовок Content-type: text/html; spam=1; Spam=2; Spam то getplist() вернёт список Python ['spam=1', 'spam=2', 'Spam'].

Message.getparam(name)

Возвращает значение первого параметра (как возвращается getplist()) вида name=value для данного name. Если значение окружено кавычками вида ‘<…>’ или ‘"…"’, они удаляются.

Message.getencoding()

Возвращает кодировку, указанную в заголовке сообщения Content-Transfer-Encoding. Если такого заголовка нет, возвращает '7bit'. Кодировка преобразуется в нижний регистр.

Message.gettype()

Возвращает тип сообщения (формата type/subtype) как указано в заголовке Content-Type. Если такого заголовка нет, возвращает 'text/plain'. Тип преобразуется в нижний регистр.

Message.getmaintype()

Возвращает основной тип, как указано в заголовке Content-Type. Если такого заголовка нет, возвращает 'text'. Основной тип преобразуется в нижний регистр.

Message.getsubtype()

Возвращает подтип, как указано в заголовке Content-Type. Если такого заголовка нет, возвращает 'plain'. Подтип преобразуется в нижний регистр.