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) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies». Кодирование 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().