(Ruby) Download Unread Email from IMAP Mailbox

Download unread email messages from an IMAP mailbox.

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

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

success = false

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

imap = Chilkat::CkImap.new()

# Connect to an IMAP server.
# Use TLS
imap.put_Ssl(true)
imap.put_Port(993)
success = imap.Connect("imap.example.com")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

# Login
success = imap.Login("admin@chilkatsoft.com","myPassword")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

# Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

# Find emails marked as seen or not already seen:
seenSearch = "SEEN"
notSeenSearch = "NOT SEEN"

# Get the set of unseen message UIDs
fetchUids = true
messageSet = Chilkat::CkMessageSet.new()
success = imap.QueryMbx(notSeenSearch,fetchUids,messageSet)
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

# Fetch the unseen emails into a bundle object:
bundle = Chilkat::CkEmailBundle.new()
headersOnly = false
success = imap.FetchMsgSet(headersOnly,messageSet,bundle)
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

# Display the Subject and From of each email.
email = Chilkat::CkEmail.new()
i = 0
numEmails = bundle.get_MessageCount()
while i < numEmails
    bundle.EmailAt(i,email)

    print email.getHeaderField("Date") + "\n";
    print email.subject() + "\n";
    print email.ck_from() + "\n";
    print "--" + "\n";
    i = i + 1
end

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