larzemail

Build, parse and send MIME email the easy way — zero dependencies.

Python's email package is powerful and famously awkward. larzemail wraps it in a one-object API: set a subject, text and/or HTML body, and attachments, then get valid MIME bytes — or parse a raw message straight back into a plain object. It also sends over SMTP, with an injectable connection so your sending code stays unit-testable.

Install

pip install larzemail

Use

from larzemail import Email

msg = (Email(subject="Your receipt", from_addr="billing@acme.com",
             to=["ada@example.com"], cc="ops@acme.com")
       .body(text="Thanks for your order.",
             html="<h1>Thanks!</h1><p>Your order shipped.</p>")
       .attach("receipt.pdf", pdf_bytes, "application/pdf"))

raw = msg.as_bytes()                 # valid MIME, ready to send
msg.send(host="smtp.acme.com", port=587, username="u", password="p", use_tls=True)

parsed = Email.parse(raw)            # -> ParsedEmail
parsed.subject, parsed.text, parsed.html, parsed.attachments

Testable sending

msg.send(connection=fake_smtp)       # any object with send_message(msg, from_addr, to_addrs)

Tests

python -m unittest discover -s tests -v   # 9 tests

The Larz stack

One of 60+ pure-Python, zero-dependency libraries at github.com/larz-scripter. Pairs with larzpdf (attach a generated invoice) and larzical (attach a calendar invite).

License

MIT (c) larz-scripter