(Ruby) Scan for Emails with Attachments and Save Attachments to Files

Scan for emails with attachments and save attachments.

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

require 'chilkat'

# This example requires 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.someMailServer.com")
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

# Login
success = imap.Login("myLogin","myPassword")
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

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

# 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 (imap.get_LastMethodSuccess() != true)
    print imap.lastErrorText() + "\n";
    exit
end

# Fetch the email headers into a bundle object:

# bundle is a CkEmailBundle
bundle = imap.FetchHeaders(messageSet)
if (imap.get_LastMethodSuccess() != true)

    print imap.lastErrorText() + "\n";
    exit
end

# Scan for emails with attachments, and save the attachments
# to a sub-directory.

for i in 0 .. bundle.get_MessageCount() - 1

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

    # Does this email have attachments?
    # Use GetMailNumAttach because the attachments
    # are not actually in the email object because
    # we only downloaded headers.
    # (Had we downloaded the full emails by
    # calling mailman.FetchBundle, we could look
    # at the email object's NumAttachments property.)
    numAttach = imap.GetMailNumAttach(email)

    if (numAttach > 0)
        # Download the entire email and save the
        # attachments. (Remember, we 
        # need to download the entire email because
        # only the headers were previously downloaded.
        # If the entire emails were downloaded by
        # calling FetchBundle instead of FetchHeaders,
        # this would not be necessary.

        # The ckx-imap-uid header field is added when
        # headers are downloaded.  This makes it possible
        # to get the UID from the email object.
        uidStr = email.getHeaderField("ckx-imap-uid")
        uid = uidStr.to_i()

        # fullEmail is a CkEmail
        fullEmail = imap.FetchSingle(uid,true)
        if (imap.get_LastMethodSuccess() == true)
            success = fullEmail.SaveAllAttachments("attachmentsDir")

        end

        for j in 0 .. numAttach - 1
            filename = imap.getMailAttachFilename(email,j)
            print filename + "\n";
        end

    end

end

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