In _message method of Message class, all attachments are attached to the msg MIMEMultipart. When images are added to be inlined in the html part, they will be shown twice in Apple Mail OS X and iOS clients. Please refer to http://stackoverflow.com/questions/10103210/displaying-inline-images-on-iphone-ipad for a better explanation.
Would it be possible to add an option to attach method of Message class to specify that an attachment should be attached to the alternative MIMEMultipart?