19.9. 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=False)¶

Декодирует содержимое файла input и записывает полученные декодированные двоичные данные в файл output. input и output должны быть двоичными файловыми объектами. Если необязательный аргумент header присутствует и равен true, символ подчеркивания будет декодирован как пробел. Это используется для декодирования заголовков, закодированных в формате «Q», как описано в RFC 1522: «MIME (Multipurpose Internet Mail Extensions) Часть 2: Расширения заголовков сообщений для не-ASCII текста».

quopri.encode(input, output, quotetabs, header=False)¶

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

quopri.decodestring(s, header=False)¶

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

quopri.encodestring(s, quotetabs=False, header=False)¶

Подобна encode(), за исключением того, что принимает исходные bytes и возвращает соответствующие закодированные bytes. По умолчанию передаёт значение False параметру quotetabs функции encode().