5 Best Ways to Utilize the SMTP Protocol Client in Python’s SMTPLib

by

💡 Problem Formulation: When you need to send emails from your Python application, the SMTP protocol is often used to communicate with the email server. The “smtplib” library in Python provides a client-side SMTP protocol interface, but it can be challenging to know how to implement this effectively. This article will demonstrate five methods to send emails using “smtplib” with examples ranging from a basic send to more advanced features like sending attachments and handling secure connections.

Method 1: Basic Email Sending

This method is the simplest way of sending an email using Python’s “smtplib”. The “SMTP” class within the library is utilized to establish a connection to the email server, and the “sendmail” method is then used to send the email.

Here’s an example:

import smtplib

server = smtplib.SMTP('smtp.example.com', 587)
server.starttls()
server.login('youremail@example.com', 'password')
server.sendmail('youremail@example.com', 'recipient@example.com', 'Subject: Hello\n\nThis is the body of the email.')
server.quit()

Output: Email sent (if no error messages are received).

This code snippet first establishes a connection with the SMTP server at ‘smtp.example.com’ using port 587, then it switches the connection to a TLS-protected one, logs in with the given credentials, sends an email with a subject and body, and finally terminates the connection.

Method 2: Sending HTML Content

When you want the email to include HTML content for a richer presentation, you could use the “MIMEText” from “email.mime.text” to specify the email’s MIME type as HTML.

Here’s an example:

from email.mime.text import MIMEText
import smtplib

html = '''\
<html>
  <body>
    <p>Hi,<br>
       How are you?<br>
       Here is the <a href="http://www.python.org">link</a> you wanted.
    </p>
  </body>
</html>
'''

message = MIMEText(html, 'html')
message['Subject'] = 'Hello'
message['From'] = 'youremail@example.com'
message['To'] = 'recipient@example.com'

server = smtplib.SMTP('smtp.example.com', 587)
server.starttls()
server.login('youremail@example.com', 'password')
server.send_message(message)
server.quit()

Output: HTML email sent (if no error messages are received).

This snippet crafts an HTML email including hyperlinks and formatted text. It then sends this HTML content as the body of the email, again using the “smtplib” to manage the SMTP connection and send the email.

Method 3: Adding Attachments

Attachments can be sent in emails by creating a “MIMEMultipart” object and attaching the file to it. The “MIMEBase” from “email.mime.base” can be used to create the payload which then gets encoded and added to the message.

Here’s an example:

from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
import smtplib

msg = MIMEMultipart()
msg['From'] = 'youremail@example.com'
msg['To'] = 'recipient@example.com'
msg['Subject'] = 'Send with attachment'

body = 'Please find the attachment.'
msg.attach(MIMEText(body, 'plain'))

filename = 'example.pdf'
attachment = open('example.pdf', 'rb')

part = MIMEBase('application', 'octet-stream')
part.set_payload((attachment).read())
encoders.encode_base64(part)
part.add_header('Content-Disposition', "attachment; filename= %s" % filename)

msg.attach(part)

server = smtplib.SMTP('smtp.example.com', 587)
server.starttls()
server.login(msg['From'], 'password')
server.send_message(msg)
server.quit()
attachment.close()

Output: Email with attachment sent (if no error messages are received).

This code builds a multi-part message, attaches a body of text, and then attaches a file. The payload is encoded in base64 to ensure that it conforms to SMTP protocols before it is sent.

Method 4: Sending Emails with Images Embedded

If you need to send embedded images within the email body, “MIMEImage” from “email.mime.image” can be used. Linked images using the HTML <img> tag can reference these embedded images by their Content-ID (CID).

Here’s an example:

from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.image import MIMEImage
import smtplib

msg = MIMEMultipart()
msg['Subject'] = 'Email with Image'
msg['From'] = 'youremail@example.com'
msg['To'] = 'recipient@example.com'

msg.attach(MIMEText('<html><body><p>Look at this image:</p><img src="cid:image1"><br></body></html>', 'html'))

with open('image.jpg', 'rb') as img:
    mime = MIMEImage(img.read(), _subtype="jpg")
    mime.add_header('Content-ID', '<image1>')
    mime.add_header('Content-Disposition', 'inline', filename='image.jpg')
    msg.attach(mime)

server = smtplib.SMTP('smtp.example.com', 587)
server.starttls()
server.login('youremail@example.com', 'password')
server.send_message(msg)
server.quit()

Output: Email with embedded image sent (if no error messages are received).

The code demonstrates sending an email which includes an embedded image. Here, the image file is read, turned into a MIMEImage object that is marked with a specific Content-ID for reference in the HTML content of the message.

Bonus One-Liner Method 5: Sending a Simple Email with Sendmail Utility

For a quick and unformatted text email, Python’s “smtplib” allows for a one-liner approach where no login is necessary (assuming the server does not require authentication).

Here’s an example:

smtplib.SMTP('smtp.example.com').sendmail('from@example.com', 'to@example.com', 'Subject: Hi\n\nThis is a quick email.')

Output: Simple email sent (if no error messages are received).

This is the most stripped-down version of sending email with “smtplib”: a one-liner that connects to an SMTP server and sends a straightforward message. This method assumes the server does not need a secure connection or authentication.

Summary/Discussion

  • Method 1: Basic Email Sending. Strengths: Simple and effective for plain text emails. Weaknesses: No formatting or attachments possible.
  • Method 2: Sending HTML Content. Strengths: Enables rich text formatting and hyperlinks. Weaknesses: More complexity in the message creation.
  • Method 3: Adding Attachments. Strengths: Ability to send files along with the email. Weaknesses: Increased complexity and requires careful handling of file I/O.
  • Method 4: Sending Emails with Images Embedded. Strengths: Embedded images make emails visually appealing. Weaknesses: Requires crafting multipart MIME messages with proper headers.
  • Method 5: Sending a Simple Email with Sendmail Utility. Strengths: Extremely simple and quick. Weaknesses: Only usable in trusted networks where authentication and encryption are not required.