Lua

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. Lua

local chilkat = require("chilkat")

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

local mailman = chilkat.MailMan.new()

mailman.smtp_host = "smtp.my-mail-server.com"
mailman.smtp_username = "MY_SMTP_USERNAME"
mailman.smtp_password = "MY_SMTP_PASSWORD"
mailman.smtp_ssl = true
mailman.smtp_port = 465

local email = chilkat.Email.new()

email.subject = "This is a test"
email.body = "This is a test"
email.from = "Chilkat Support <support@chilkatsoft.com>"
local success = email:add_to("Chilkat Admin", "admin@chilkatsoft.com")
-- To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

-- Add some attachments.
-- The AddFileAttachment method returns the value of the content-type it chose for the attachment.
local contentType = email:add_file_attachment("qa_data/jpg/starfish.jpg")
if not email.last_method_success then
    print(email.last_error_text)
    return
end

contentType = email:add_file_attachment("qa_data/pdf/fishing.pdf")
if not email.last_method_success then
    print(email.last_error_text)
    return
end

-- If we save the email to a .eml, we can examine in a text editor.
success = email:save_eml("qa_output/e1.eml")
if not success then
    print(email.last_error_text)
    print("Failed to save .eml")
    return
end

-- We see the following in the e1.eml
-- Notice that Chilkat replaced the full path with just the filename.
-- The full local path is not part of the email that gets sent..

-- ...
-- --------------020807050607070004010609
-- Content-Type: image/jpeg; name="starfish.jpg"
-- Content-Transfer-Encoding: base64
-- Content-Disposition: attachment; filename="starfish.jpg"
--
-- ...
-- --------------020807050607070004010609
-- Content-Type: application/pdf; name="fishing.pdf"
-- Content-Transfer-Encoding: base64
-- Content-Disposition: attachment; filename="fishing.pdf"
-- ...

-- Before sending, each filename can be changed within the email object.
-- For example:
success = email:set_attachment_filename(0, "orange_starfish.jpg")
success = email:set_attachment_filename(1, "tuna_fishing.pdf")

-- Look at the new MIME source of the email in a  text editor...
success = email:save_eml("qa_output/e2.eml")
if not success then
    print(email.last_error_text)
    print("Failed to save .eml")
    return
end

-- You'll see this:

-- ...
-- --------------020807050607070004010609
-- Content-Type: image/jpeg; name="orange_starfish.jpg"
-- Content-Transfer-Encoding: base64
-- Content-Disposition: attachment; filename="orange_starfish.jpg"
--
-- ...
-- --------------020807050607070004010609
-- Content-Type: application/pdf; name="tuna_fishing.pdf"
-- Content-Transfer-Encoding: base64
-- Content-Disposition: attachment; filename="tuna_fishing.pdf"
-- ...

-- Send the email with the updated filenames..
success = mailman:send_email(email)
if not success then
    print(mailman.last_error_text)
    return
end

success = mailman:close_smtp_connection()
if not success then
    print("Connection to SMTP server not closed cleanly.")
end

print("Mail with attachments sent!")