README.md

Red Mail: Advanced Email Sender

Next generation email sender

---

What is it?

Red Mail is an advanced email sender library. It is a sister library for Red Box, advanced email reader. It makes sending emails trivial and has a lot of advanced features such as:

• Attachments
• Templating (with Jinja)
• Embedded images
• Prettified tables
• Send as cc or bcc
• Gmail preconfigured

See more from the documentations or see release from PyPI.

Install it from PyPI:

pip install redmail

Why Red Mail?

Sending emails SHOULD NOT be this complicated:

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

msg = MIMEMultipart('alternative')
msg['Subject'] = 'An example email'
msg['From'] = '[email protected]'
msg['To'] = '[email protected]'

part1 = MIMEText("Hello!", 'plain')
part2 = MIMEText("<h1>Hello!</h1>", 'html')

msg.attach(part1)
msg.attach(part2)

# Send the message via our own SMTP server.
s = smtplib.SMTP('localhost', port=0)
s.send_message(msg)
s.quit()

With Red Mail, it is simple as this:

from redmail import EmailSender

email = EmailSender(host="localhost", port=0)

email.send(
    subject="An example email",
    sender="[email protected]",
    receivers=['[email protected]'],
    text="Hello!",
    html="<h1>Hello!</h1>"
)

More examples:

• simple example
• email with attachments
• email with embedded images
• email with embedded plots
• email with body parameters

See practical examples from the cookbook.

---

Author

• Mikael Koli - Miksus - [email protected]