Software: Apache/2.0.54 (Unix) mod_perl/1.99_09 Perl/v5.8.0 mod_ssl/2.0.54 OpenSSL/0.9.7l DAV/2 FrontPage/5.0.2.2635 PHP/4.4.0 mod_gzip/2.0.26.1a 

uname -a: Linux snow.he.net 4.4.276-v2-mono-1 #1 SMP Wed Jul 21 11:21:17 PDT 2021 i686 

uid=99(nobody) gid=98(nobody) groups=98(nobody) 

Safe-mode: OFF (not secure)

/usr/doc/python-2.2.3/html/lib/   drwxr-xr-x
Free 318.38 GB of 458.09 GB (69.5%)
                            Encoder    Tools    Proc.    FTP brute    Sec.    SQL    PHP-code    Update    Feedback    Self remove    Logout    

Viewing file:     module-email.Encoders.html (6.27 KB)      -rw-r--r--

Python Library Reference

Previous: 12.2.6 Representing character sets Up: 12.2 email Next: 12.2.8 Exception classes

---

12.2.7 Encoders

When creating Message objects from scratch, you often need to encode the payloads for transport through compliant mail servers. This is especially true for image/* and text/* type messages containing binary data.

The email package provides some convenient encodings in its Encoders module. These encoders are actually used by the MIMEImage and MIMEText class constructors to provide default encodings. All encoder functions take exactly one argument, the message object to encode. They usually extract the payload, encode it, and reset the payload to this newly encoded value. They should also set the Content-Transfer-Encoding: header as appropriate.

Here are the encoding functions provided:

encode_quopri(msg)

Encodes the payload into quoted-printable form and sets the Content-Transfer-Encoding: header to quoted-printable^12.1. This is a good encoding to use when most of your payload is normal printable data, but contains a few unprintable characters.

encode_base64(msg)

Encodes the payload into base64 form and sets the Content-Transfer-Encoding: header to base64. This is a good encoding to use when most of your payload is unprintable data since it is a more compact form than quoted-printable. The drawback of base64 encoding is that it renders the text non-human readable.

encode_7or8bit(msg)

This doesn't actually modify the message's payload, but it does set the Content-Transfer-Encoding: header to either 7bit or 8bit as appropriate, based on the payload data.

encode_noop(msg)

This does nothing; it doesn't even set the Content-Transfer-Encoding: header.

Footnotes

...quoted-printable^12.1

Note that encoding with encode_quopri() also encodes all tabs and space characters in the data.

---

Python Library Reference

Previous: 12.2.6 Representing character sets Up: 12.2 email Next: 12.2.8 Exception classes

---

Release 2.2.3, documentation updated on 30 May 2003.