py3mailer

About

A simple and convenient way to send emails ✉️ in python 🐍

Installation

pip install py3mailer

Usage guide

1. Importing the module

   from pymailer import EmailService, build_message
   

2. Build an email message

   • Simple EmailMessage

     message = build_message(fr_addr='[e-mail]', # Sender
                             to_addrs=['[e-mail]'], # List of recipients
                             cc_addrs=['[e-mail]' ], # List of secondary recipents
                             subject='Subject of Email',
                             content="Plain text contents of the email")
     

   • Extended EmailMessage with html body and attachments

     message = build_message(fr_addr='[e-mail]', # Sender
                             to_addrs=['[e-mail]'], # List of recipients
                             cc_addrs=['[e-mail]' ], # List of secondary recipents
                             subject='Subject of Email',
                             content="Plain text contents of the email",
                             htmlcontent="<h1>Fancy</h1> html content of the email",
                             attachments=['absolute path to the attachment'])
     

3. Instantiate EmailSevice and send the message

   service = EmailService(host='smtp.gmail.com',
                          port=587,
                          user='[e-mail]',
                          password='This is super secret')
   
   service.sendmail(message)
   

Additional notes:

• While creating EmailService its optional to specify the password. If the password is not specified it is assumed that the smtp email server does not require authentication.