(Chilkat2-Python) Imap.GetMailSize vs Email.Size

Shows how to get the total size of an email, as well as the sizes of the attachments. This can be done when either full-emails or headers-only are downloaded.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat2 Python Downloads install with pip pip3 install chilkat2 or download... Python Module for Windows, Linux, Alpine Linux, MacOS

import sys
import chilkat2

success = False

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

imap = chilkat2.Imap()

# Connect to an IMAP server.
# Use TLS
imap.Ssl = True
imap.Port = 993
success = imap.Connect("imap.someMailServer.com")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Login
success = imap.Login("****","****")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Get the message IDs of all the emails in the mailbox
# We can choose to fetch UIDs or sequence numbers.
fetchUids = True
messageSet = chilkat2.MessageSet()
success = imap.QueryMbx("ALL",fetchUids,messageSet)
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# When downloading headers, each email object contains
# (obviously) the headers, but the body will be missing.
# Attachments will not be included.  However, it is
# possible to get information about the attachments
# as well as the complete size of the email.
bundle = chilkat2.EmailBundle()
headersOnly = True
success = imap.FetchMsgSet(headersOnly,messageSet,bundle)
if (success == False):
    print(imap.LastErrorText)
    sys.exit()

# Loop over the email objects and display information about each:
email = chilkat2.Email()
i = 0
j = 0
numEmails = bundle.MessageCount
while i < numEmails :
    bundle.EmailAt(i,email)

    # Display the From and Subject
    print(email.From)
    print(email.Subject)

    # Display the recipients:
    j = 0
    while j < email.NumTo :
        print("TO: " + email.GetToName(j) + ", " + email.GetToAddr(j))
        j = j + 1

    j = 0
    while j < email.NumCC :
        print("CC: " + email.GetCcName(j) + ", " + email.GetCcAddr(j))
        j = j + 1

    # Show the total size of the email, including body and attachments:
    print(str(email.Size))

    # When a full email is downloaded, we would use the
    # email.NumAttachments property in conjunction with the
    # email.GetMailAttach* methods.
    # However, when an email object contains only the header,
    # we need to access the attachment info differently:
    numAttach = imap.GetMailNumAttach(email)
    j = 0
    while j < numAttach :
        print(imap.GetMailAttachFilename(email,j))
        attachSize = imap.GetMailAttachSize(email,j)
        print("    size = " + str(attachSize) + " bytes")
        j = j + 1

    print("--")

    i = i + 1

# Disconnect from the IMAP server.
success = imap.Disconnect()