Lib/email/MIMEMultipart.py

# Copyright (C) 2002 Python Software Foundation
# Author: barry@zope.com (Barry Warsaw)

"""Base class for MIME multipart/* type messages.
"""

from email import MIMEBase



class MIMEMultipart(MIMEBase.MIMEBase):
    """Base class for MIME multipart/* type messages."""

    def __init__(self, _subtype='mixed', boundary=None, *_subparts, **_params):
        """Creates a multipart/* type message.

        By default, creates a multipart/mixed message, with proper
        Content-Type: and MIME-Version: headers.

        _subtype is the subtype of the multipart content type, defaulting to
        `mixed'.

        boundary is the multipart boundary string.  By default it is
        calculated as needed.

        _subparts is a sequence of initial subparts for the multipart.  It
        must be possible to convert this sequence to a list.  You can always
        attach new subparts to the message by using the attach() method.

        Additional parameters for the Content-Type: header are taken from the
        keyword arguments (or passed into the _params argument).
        """
        MIMEBase.MIMEBase.__init__(self, 'multipart', _subtype, **_params)
        if _subparts:
            self.attach(*list(_subparts))
        if boundary:
            self.set_boundary(boundary)