Class Attachment

source code

email.message.Message --+    
                        |    
 email.mime.base.MIMEBase --+
                            |
                           Mail.Attachment

Email attachment

Arguments:

    payload: path to file or file-like object with read() method
    filename: name of the attachment stored in message; if set to
              None, it will be fetched from payload path; file-like
              object payload must have explicit filename specified
    content_id: id of the attachment; automatically contained within
                < and >
    content_type: content type of the attachment; if set to None,
                  it will be fetched from filename using gluon.contenttype
                  module
    encoding: encoding of all strings passed to this function (except
              attachment body)

Content ID is used to identify attachments within the html body;
in example, attached image with content ID 'photo' may be used in
html message as a source of img tag <img src="cid:photo" />.

Examples:

    #Create attachment from text file:
    attachment = Mail.Attachment('/path/to/file.txt')

    Content-Type: text/plain
    MIME-Version: 1.0
    Content-Disposition: attachment; filename="file.txt"
    Content-Transfer-Encoding: base64

    SOMEBASE64CONTENT=

    #Create attachment from image file with custom filename and cid:
    attachment = Mail.Attachment('/path/to/file.png',
                                     filename='photo.png',
                                     content_id='photo')

    Content-Type: image/png
    MIME-Version: 1.0
    Content-Disposition: attachment; filename="photo.png"
    Content-Id: <photo>
    Content-Transfer-Encoding: base64

    SOMEOTHERBASE64CONTENT=