Skip to main content

Python email utils

Project description

kmailbox is a python email library, support for sending and receiving emails via SMTP and IMAP protocol.

send plain text email:

from kmailbox import Message, MailBox

msg = Message()
msg.sender = "Tester<test@google.com>"
msg.recipient = "hello@google.com"
msg.subject = "kmailbox test"
msg.content = "This is test"

mailbox = MailBox(smtp_host="smtp.gmail.com", use_tls=True)
mailbox.username = "username"
mailbox.password = "password"
mailbox.send(msg)

send html email:

msg = Message()
msg.sender = "Tester<test@google.com>"
msg.recipient = "hello@google.com"
msg.subject = "kmailbox test send html and add attachments"
msg.is_html = True
msg.content = """\
<body>
<p><img src="cid:0"></p>

<p>Hello! I am <em>Huoty</em>.</p>

<p>How are you?</p>

<p>Give you a picture:</p>
<p><img src="cid:1"></p>
</body>
"""
msg.attachments = [
    "cid0:imgs/mailbox-icon.png",
    "cid1:imgs/20171005170550.jpg",
    "kmailbox.py",
    "README.md"
]

mailbox = MailBox(
    smtp_host="smtp.gmail.com",
    use_ssl=True,
    username="username",
    password="password",
)
mailbox.send(msg)

receive mails:

mailbox = MailBox(imap_host="imap.gmail.com", use_ssl=True)
mailbox.username = "username"
mailbox.password = "password"
mailbox.select()
for mail in mailbox.all(mark_seen=False, gen=True):
    pprint({
        "uid": mail.uid,
        "sender": mail.sender,
        "to_addrs": mail.to_addrs,
        "subject": mail.subject,
        "date": str(mail.date),
        "flags": mail.flags,
        "attachments": [att.filename for att in mail.attachments],
    })
mailbox.close()

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kmailbox-0.2.5.tar.gz (14.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kmailbox-0.2.5-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file kmailbox-0.2.5.tar.gz.

File metadata

  • Download URL: kmailbox-0.2.5.tar.gz
  • Upload date:
  • Size: 14.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for kmailbox-0.2.5.tar.gz
Algorithm Hash digest
SHA256 1f3a3cca9b4d4856a145d99ef96313270d613d227ad973a65cfdf51a160ad197
MD5 bb19bfb90f336154b9c9b031ac52c090
BLAKE2b-256 bbb47a10246afe3d0af3f7b85b57ff09708ebd18c86214fb67d4aa269bf6b608

See more details on using hashes here.

File details

Details for the file kmailbox-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: kmailbox-0.2.5-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for kmailbox-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 12c755ce508458c8d78871dcc32eedfaedb269c279a1d26f27d7091b949e579a
MD5 78d09817a4827af465fade477cca9060
BLAKE2b-256 c08f4aa4b340faaf56399b4a3702a1a58c9de2719a144c5bca1ee02332675471

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page