18.15. quopri – Кодирование и декодирование MIME quoted-printable данных¶quopri – Encode and decode MIME quoted-printable data

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

Этот модуль выполняет кодирование и декодирование транспортной кодировки quoted-printable, как определено в RFC 1521: «MIME (Multipurpose Internet Mail Extensions) Часть 1: Механизмы спецификации и описания формата тел интернет-сообщений». Кодировка quoted-printable предназначена для данных, в которых относительно мало непечатаемых символов; схема кодирования base64, доступная через модуль base64, более компактна, если таких символов много, например, при отправке графического файла.

quopri.decode(input, output[, header])¶

Декодирует содержимое файла input и записывает полученные декодированные двоичные данные в файл output. input и output должны быть файловыми объектами или объектами, имитирующими интерфейс файлового объекта. input читается до тех пор, пока input.readline() не вернёт пустую строку. Если необязательный аргумент header присутствует и равен true, символ подчёркивания декодируется как пробел. Это используется для декодирования заголовков, закодированных в формате «Q», как описано в RFC 1522: «MIME (Multipurpose Internet Mail Extensions) Part Two: Message Header Extensions for Non-ASCII Text».

quopri.encode(input, output, quotetabs)¶

Кодирует содержимое файла input и записывает полученные quoted-printable данные в файл output. input и output должны быть файловыми объектами или объектами, имитирующими интерфейс файлового объекта. input читается до тех пор, пока input.readline() не вернёт пустую строку. quotetabs – это флаг, который управляет кодированием встроенных пробелов и табуляций; если true, он кодирует такие встроенные пробельные символы, а если false – оставляет их незакодированными. Обратите внимание, что пробелы и табуляции в конце строк всегда кодируются, согласно RFC 1521.

quopri.decodestring(s[, header])¶

Как decode(), за исключением того, что принимает исходную строку и возвращает соответствующую декодированную строку.

quopri.encodestring(s[, quotetabs])¶

Как encode(), за исключением того, что принимает исходную строку и возвращает соответствующую закодированную строку. quotetabs является необязательным (по умолчанию 0) и передаётся напрямую в encode().