GNU Info

(python2.1-lib.info)mimetools

---

Next: MimeWriter Prev: rfc822 Up: Internet Data Handling

---

Enter node , (file) or (file)node

Tools for parsing MIME messages
===============================

Tools for parsing MIME-style message bodies.

This module defines a subclass of the `rfc822'  module's `Message'
class and a number of utility functions that are useful for the
manipulation for MIME multipart or encoded message.

It defines the following items:

`Message(fp[, seekable])'
     Return a new instance of the `Message' class.  This is a subclass
     of the `rfc822.Message' class, with some additional methods (see
     below).  The SEEKABLE argument has the same meaning as for
     `rfc822.Message'.

`choose_boundary()'
     Return a unique string that has a high likelihood of being usable
     as a part boundary.  The string has the form
     `'HOSTIPADDR.UID.PID.TIMESTAMP.RANDOM''.

`decode(input, output, encoding)'
     Read data encoded using the allowed MIME ENCODING from open file
     object INPUT and write the decoded data to open file object
     OUTPUT.  Valid values for ENCODING include `'base64'',
     `'quoted-printable'' and `'uuencode''.

`encode(input, output, encoding)'
     Read data from open file object INPUT and write it encoded using
     the allowed MIME ENCODING to open file object OUTPUT.  Valid
     values for ENCODING are the same as for `decode()'.

`copyliteral(input, output)'
     Read lines from open file INPUT until `EOF' and write them to open
     file OUTPUT.

`copybinary(input, output)'
     Read blocks until `EOF' from open file INPUT and write them to
     open file OUTPUT.  The block size is currently fixed at 8192.

See also:
     Note: rfc822 Provides the base class for `mimetools.Message'.
     Note: multifile Support for reading files which contain distinct
     parts, such as MIME data.

    <http://www.cs.uu.nl/wais/html/na-dir/mail/mime-faq/.html>
          The MIME Frequently Asked Questions document.  For an
          overview of MIME, see the answer to question 1.1 in Part 1 of
          this document.

Additional Methods of Message Objects