email.encoders.md

1> **Источник:** https://python-all.ru/3.3/library/email.encoders.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 19.1.9. [`email.encoders`](https://python-all.ru/3.3/library/email.encoders.html#module-email.encoders): Кодеры89При создании объектов [`Message`](https://python-all.ru/3.3/library/email.message.html#email.message.Message) с нуля часто требуется закодировать полезную нагрузку для передачи через совместимые почтовые серверы. Это особенно актуально для сообщений типов *image/\** и *text/\**, содержащих двоичные данные.1011Пакет [`email`](https://python-all.ru/3.3/library/email.html#module-email) предоставляет несколько удобных кодировок в своём модуле `encoders`. Эти кодировщики фактически используются конструкторами классов [`MIMEAudio`](https://python-all.ru/3.3/library/email.mime.html#email.mime.audio.MIMEAudio) и [`MIMEImage`](https://python-all.ru/3.3/library/email.mime.html#email.mime.image.MIMEImage) для предоставления кодировок по умолчанию. Все функции-кодировщики принимают ровно один аргумент – кодируемый объект сообщения. Обычно они извлекают полезную нагрузку, кодируют её и заменяют на новое закодированное значение. Также они должны устанавливать заголовок *Content-Transfer-Encoding* соответствующим образом.1213Обратите внимание, что эти функции не имеют смысла для многокомпонентного сообщения. Их следует применять к отдельным подкомпонентам, и при передаче сообщения типа multipart будет возбуждено исключение [`TypeError`](https://python-all.ru/3.3/library/exceptions.html#TypeError).1415Вот предоставленные функции кодирования:1617#### `email.encoders.encode_quopri(msg)`1819Кодирует полезную нагрузку в формат quoted-printable и устанавливает заголовок *Content-Transfer-Encoding* в значение `quoted-printable` [\[1\]](https://python-all.ru/3.3/library/email.encoders.html#id2). Это хорошая кодировка, когда большая часть полезной нагрузки – обычные печатаемые данные, но встречается несколько непечатаемых символов.2021#### `email.encoders.encode_base64(msg)`2223Кодирует полезную нагрузку в формат base64 и устанавливает заголовок *Content-Transfer-Encoding* в значение `base64`. Это хорошая кодировка, когда большая часть полезной нагрузки – непечатаемые данные, поскольку она более компактна по сравнению с quoted-printable. Недостаток кодировки base64 в том, что она делает текст нечитаемым для человека.2425#### `email.encoders.encode_7or8bit(msg)`2627Эта функция на самом деле не изменяет полезную нагрузку сообщения, но устанавливает заголовок *Content-Transfer-Encoding* в значение `7bit` или `8bit` в зависимости от данных полезной нагрузки.2829#### `email.encoders.encode_noop(msg)`3031Эта функция ничего не делает; она даже не устанавливает заголовок *Content-Transfer-Encoding*.3233Сноски3435| [\[1\]](https://python-all.ru/3.3/library/email.encoders.html#id1) | Обратите внимание, что кодирование с помощью [`encode_quopri()`](https://python-all.ru/3.3/library/email.encoders.html#email.encoders.encode_quopri) также кодирует все символы табуляции и пробела в данных. |36| --- | --- |37