
``quopri`` --- Encode and decode MIME quoted-printable data
***********************************************************

This module performs quoted-printable transport encoding and decoding,
as defined in **RFC 1521**: "MIME (Multipurpose Internet Mail
Extensions) Part One: Mechanisms for Specifying and Describing the
Format of Internet Message Bodies". The quoted-printable encoding is
designed for data where there are relatively few nonprintable
characters; the base64 encoding scheme available via the ``base64``
module is more compact if there are many such characters, as when
sending a graphics file.

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

   Decode the contents of the *input* file and write the resulting
   decoded binary data to the *output* file. *input* and *output* must
   be *file objects*.  *input* will be read until ``input.readline()``
   returns an empty string. If the optional argument *header* is
   present and true, underscore will be decoded as space. This is used
   to decode "Q"-encoded headers as described in **RFC 1522**: "MIME
   (Multipurpose Internet Mail Extensions) Part Two: Message Header
   Extensions for Non-ASCII Text".

quopri.encode(input, output, quotetabs)

   Encode the contents of the *input* file and write the resulting
   quoted-printable data to the *output* file. *input* and *output*
   must be *file objects*.  *input* will be read until
   ``input.readline()`` returns an empty string. *quotetabs* is a flag
   which controls whether to encode embedded spaces and tabs; when
   true it encodes such embedded whitespace, and when false it leaves
   them unencoded.  Note that spaces and tabs appearing at the end of
   lines are always encoded, as per **RFC 1521**.

quopri.decodestring(s[, header])

   Like ``decode()``, except that it accepts a source string and
   returns the corresponding decoded string.

quopri.encodestring(s[, quotetabs])

   Like ``encode()``, except that it accepts a source string and
   returns the corresponding encoded string.  *quotetabs* is optional
   (defaulting to 0), and is passed straight through to ``encode()``.

See also:

   Module ``base64``
      Encode and decode MIME base64 data
