mimify — MIME обработка сообщений почты

Модуль mimify определяет две функции для преобразования сообщений электронной почты в и из формата MIME. Сообщение электронной почты может быть простым сообщением или так называемым многочастьным сообщением. Каждая часть обрабатывается отдельно. Преобразование (части) сообщения в MIME формат включает кодирование сообщения как quoted-printable, если оно содержит символы, которые не могут быть представлены с помощью 7-битной ASCII. Обратное преобразование (части) сообщения включает отмену кодирования quoted-printable. Mimify и unmimify особенно полезны, когда сообщение должно быть отредактировано перед отправкой. Типичное использование:

unmimify message
edit message
mimify message
send message

Модуль определяет следующие вызываемые пользователем функции и настраиваемые переменные:

mimify.mimify(infile, outfile)

Скопировать сообщение из infile в outfile, преобразовав части в quoted-printable и добавив заголовки почты MIME при необходимости. infile и outfile могут быть объектами файлов (на самом деле, любым объектом, имеющим метод readline() (для infile) или метод write() (для outfile)) или строками, именами файлов. Если infile и outfile — обе строки, они могут иметь одинаковое значение.

mimify.unmimify(infile, outfile[, decode_base64])

Скопировать сообщение из infile в outfile, декодируя все части quoted-printable. infile и outfile могут быть объектами файлов (на самом деле, любым объектом, имеющим метод readline() (для infile) или метод write() (для outfile)) или строками, именами файлов. Если infile и outfile — обе строки, они могут иметь одинаковое значение. Если аргумент decode_base64 задан и истиннен, то любые части, закодированные в base64, будут также декодированы.

mimify.mime_decode_header(line)

Возвращает декодированную версию закодированной строки заголовка в line. Поддерживается только кодировка ISO 8859-1 (Latin-1).

mimify.mime_encode_header(line)

Возвращает MIME-закодированную версию строки заголовка в line.

mimify.MAXLEN

По умолчанию часть будет закодирована как quoted-printable, когда она содержит не-ASCII символы (символы с 8-м битом установленным) или если есть строки длиннее, чем MAXLEN символов (значение по умолчанию 200).

mimify.CHARSET

Если кодировка не указана в заголовках почты, она должна быть задана. Строка хранится в CHARSET, значение по умолчанию — ISO-8859-1 (также известная как Latin1 (latin-one)).

Этот модуль также может быть использован из командной строки. Использование:

mimify.py -e [-l length] [infile [outfile]]
mimify.py -d [-b] [infile [outfile]]

для кодирования (mimify) и декодирования (unmimify) соответственно. infile по умолчанию — стандартный ввод, outfile — стандартный вывод. Один и тот же файл может быть указан для ввода и вывода.

Если опция -l задана при кодировании, если есть строки длиннее, чем заданная длина, содержащая часть будет закодирована.

Если опция -b задана при декодировании, любые части base64 будут декодированы.