Class Attachment

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

Email attachment

   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" />.

   #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=