realpython · JFincher42 · Apr 6, 2026 · Apr 6, 2026
diff --git a/python-email/README.md b/python-email/README.md
@@ -0,0 +1 @@
+Source files supporting [Sending Emails with Python](https://realpython.com/python-send-email/) article on [Real Python](https://realpython.com)
diff --git a/python-email/address-email.py b/python-email/address-email.py
@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+
+import csv
+
+from send_msg import send
+from email.message import EmailMessage
+from email.headerregistry import Address
+
+sender_email = "my@gmail.com"
+sender = Address(display_name="Me", addr_spec=sender_email)
+
+with open("contacts.csv") as file:
+    reader = csv.reader(file)
+    next(reader)  # Skip header row
+    for name, email, grade in reader:
+        recipient = Address(display_name=name, addr_spec=email)
+        msg = EmailMessage()
+        msg["to"] = recipient
+        msg["from"] = sender
+        msg["Subject"] = "Your grade"
+        msg.set_content(f"Congratulations, {name}, you got a {grade}.")
+
+        send(msg, sender_email)
diff --git a/python-email/attachment-email.py b/python-email/attachment-email.py
@@ -0,0 +1,28 @@
+#!/usr/bin/env python3
+
+from send_msg import send
+from email.message import EmailMessage
+from os.path import basename
+
+sender_email = "my@gmail.com"
+receiver_email = "your@gmail.com"
+
+# Build Email Message
+msg = EmailMessage()
+msg["to"] = receiver_email
+msg["from"] = sender_email
+msg["subject"] = "Attachment Test Message"
+
+text = "Please find a JPG attached."
+msg.add_alternative(text, subtype="plain")
+
+attachment_filename = "smiley-small.jpg"
+with open("smiley-small.jpg", "rb") as attachment:
+    attachment_data = attachment.read()
+    attachment_file = basename(attachment_filename)
+    msg.add_attachment(
+        attachment_data, maintype="image", subtype="jpeg", filename=attachment_file
+    )
+
+# Send message
+send(msg, sender_email)
diff --git a/python-email/contacts.csv b/python-email/contacts.csv
@@ -0,0 +1,4 @@
+name,email,grade
+Ron Obvious,my+obvious@gmail.com,B+
+Killer Rabbit,my+rabbit@gmail.com,A
+Brian,my+brian@gmail.com,C
diff --git a/python-email/html-email.py b/python-email/html-email.py
@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+
+from send_msg import send
+from email.message import EmailMessage
+
+sender_email = "my@gmail.com"
+receiver_email = "your@gmail.com"
+
+# Build Email Message
+msg = EmailMessage()
+msg["to"] = receiver_email
+msg["from"] = sender_email
+msg["subject"] = "HTML Test Message"
+
+text = """\
+Hi,
+How are you?
+Real Python has many great tutorials:
+realpython.com"""
+
+html = """\
+<html>
+  <body>
+    <p>Hi,<br>
+       How are you?<br>
+       <a href="http://realpython.com">Real Python</a>
+       has many great tutorials.
+    </p>
+  </body>
+</html>
+"""
+
+msg.set_content(text)
+msg.add_alternative(html, subtype="html")
+
+# Send message
+send(msg, sender_email)
diff --git a/python-email/multiple_recipients.py b/python-email/multiple_recipients.py
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+from send_msg import send
+from email.message import EmailMessage
+
+sender_email = "my@gmail.com"
+receiver_email_1 = "your@gmail.com"
+receiver_email_2 = "your_other@gmail.com"
+cc_receiver_email = "cc-you@gmail.com"
+bcc_receiver_email = "bcc-you@gmail.com"
+
+# Build Email Message
+msg = EmailMessage()
+msg["to"] = [receiver_email_1, receiver_email_2]
+msg["cc"] = cc_receiver_email
+msg["bcc"] = bcc_receiver_email
+msg["from"] = sender_email
+msg["subject"] = "Test Message"
+msg.set_content("This is a test message")
+
+# Send message
+send(msg, sender_email)
diff --git a/python-email/plain-text-email.py b/python-email/plain-text-email.py
@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+
+from send_msg import send
+from email.message import EmailMessage
+
+sender_email = "my@gmail.com"
+receiver_email = "your@gmail.com"
+
+# Build Email Message
+msg = EmailMessage()
+msg["to"] = receiver_email
+msg["from"] = sender_email
+msg["subject"] = "Test Message"
+msg.set_content("This is a test message")
+
+# Send message
+send(msg, sender_email)
diff --git a/python-email/pyproject.toml b/python-email/pyproject.toml
@@ -0,0 +1,17 @@
+[project]
+name = "python-email"
+version = "0.1.0"
+description = "Source files supporting 'Sending Emails with Python' article on RealPython"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "aiosmtpd>=1.4.6",
+    "ruff>=0.15.9",
+]
+
+[dependency-groups]
+dev = [
+    "black>=26.3.1",
+    "flake8>=7.3.0",
+    "rope>=1.14.0",
+]
diff --git a/python-email/reply-to-email.py b/python-email/reply-to-email.py
@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+
+from send_msg import send
+from email.message import EmailMessage
+
+sender_email = "my@gmail.com"
+reply_email = "my.different@gmail.com"
+receiver_email = "your@gmail.com"
+
+# Build Email Message
+msg = EmailMessage()
+msg["to"] = receiver_email
+msg["from"] = sender_email
+msg["reply-to"] = reply_email
+msg["subject"] = "Reply Please"
+msg.set_content("Replies go to a different mailbox.")
+
+# Send message
+send(msg, sender_email)
diff --git a/python-email/requirements.txt b/python-email/requirements.txt
@@ -0,0 +1,10 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml -o requirements.txt
+aiosmtpd==1.4.6
+    # via python-email (pyproject.toml)
+atpublic==7.0.0
+    # via aiosmtpd
+attrs==26.1.0
+    # via aiosmtpd
+ruff==0.15.9
+    # via python-email (pyproject.toml)
diff --git a/python-email/send_msg.py b/python-email/send_msg.py
@@ -0,0 +1,23 @@
+#!/usr/bin/env python3
+
+import smtplib
+import ssl
+from getpass import getpass
+
+
+def send(msg, sender_email, debug=True):
+    if debug:
+        port = 8025
+        smtp_server = "localhost"
+        with smtplib.SMTP(smtp_server, port) as server:
+            server.send_message(msg)
+
+    else:
+        port = 465
+        smtp_server = "smtp.gmail.com"
+        password = getpass("Type your password and press enter: ")
+
+        context = ssl.create_default_context()
+        with smtplib.SMTP_SSL(smtp_server, port, context=context) as server:
+            server.login(sender_email, password)
+            server.send_message(msg)
diff --git a/python-email/smiley-small.jpg b/python-email/smiley-small.jpg
diff --git a/python-email/smiley.jpg b/python-email/smiley.jpg
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Source files supporting [Sending Emails with Python](https://realpython.com/python-send-email/) article on [Real Python](https://realpython.com)