Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

Download Chilkat Python Library

import sys
import chilkat

imap = chilkat.CkImap()

#  Anything unlocks the component and begins a fully-functional 30-day trial.
success = imap.UnlockComponent("Anything for 30-day trial")
if (success != True):
    print imap.lastErrorText()
    sys.exit()

#  Connect to an IMAP server.
success = imap.Connect("mail.chilkatsoft.com")
if (success != True):
    print imap.lastErrorText()
    sys.exit()

#  Login
success = imap.Login("****","****")
if (success != True):
    print imap.lastErrorText()
    sys.exit()

#  Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success != True):
    print imap.lastErrorText()
    sys.exit()

#  We can choose to fetch UIDs or sequence numbers.
fetchUids = True
#  Get the message IDs of all the emails in the mailbox
# messageSet is a CkMessageSet
messageSet = imap.Search("ALL",fetchUids)
if (messageSet == None ):
    print imap.lastErrorText()
    sys.exit()

#  When downloading headers, each email object contains
#  (obviously) the headers, but the body will be missing.
#  Also, 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 is a CkEmailBundle
bundle = imap.FetchHeaders(messageSet)
if (bundle == None ):

    print imap.lastErrorText()
    sys.exit()

#  Loop over the email objects and display information
#  about each:

for i in range(0,bundle.get_MessageCount()):

    # email is a CkEmail
    email = bundle.GetEmail(i)

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

    #  Display the recipients:

    for j in range(0,email.get_NumTo()):
        name = email.getToName(j)
        addr = email.getToAddr(j)
        print name + ", " + addr

    for j in range(0,email.get_NumCC()):
        name = email.getCcName(j)
        addr = email.getCcAddr(j)
        print name + ", " + addr

    #  Show the total size of the email, including body and attachments:
    print email.get_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)
    for j in range(0,numAttach):
        print imap.getMailAttachFilename(email,j)
        attachSize = imap.GetMailAttachSize(email,j)
        print "    size = " + str(attachSize)\
             + " bytes"

    print "--"

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