Rust

Rename Email Attachments After Adding

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

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

let mailman = chilkat::MailMan::new();

mailman.set_smtp_host("smtp.my-mail-server.com");
mailman.set_smtp_username("MY_SMTP_USERNAME");
mailman.set_smtp_password("MY_SMTP_PASSWORD");
mailman.set_smtp_ssl(true);
mailman.set_smtp_port(465);

let email = chilkat::Email::new();

email.set_subject("This is a test");
email.set_body("This is a test");
email.set_from("Chilkat Support <support@chilkatsoft.com>");
let _ = email.add_to("Chilkat Admin", "admin@chilkatsoft.com").is_ok();
// 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.
let Ok(mut content_type) = email.add_file_attachment("qa_data/jpg/starfish.jpg") else {
    println!("{}", email.last_error_text());
    return;
};

content_type = email.add_file_attachment("qa_data/pdf/fishing.pdf").unwrap_or_default();
if !email.last_method_success() {
    println!("{}", email.last_error_text());
    return;
}

// If we save the email to a .eml, we can examine in a text editor.
if email.save_eml("qa_output/e1.eml").is_err() {
    println!("{}", email.last_error_text());
    println!("Failed to save .eml");
    return;
}

// 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:
let _ = email.set_attachment_filename(0, "orange_starfish.jpg").is_ok();
let _ = email.set_attachment_filename(1, "tuna_fishing.pdf").is_ok();

// Look at the new MIME source of the email in a  text editor...
if email.save_eml("qa_output/e2.eml").is_err() {
    println!("{}", email.last_error_text());
    println!("Failed to save .eml");
    return;
}

// 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..
if mailman.send_email(&email).is_err() {
    println!("{}", mailman.last_error_text());
    return;
}

if mailman.close_smtp_connection().is_err() {
    println!("Connection to SMTP server not closed cleanly.");
}

println!("Mail with attachments sent!");