📧 SecureMailer - Robust Email Sending Tool 🔐

A secure, feature-rich Python email sending utility that makes sending emails with attachments simple and safe.

✨ Features

• 🛡️ Enhanced Security: No hardcoded credentials, secure password input
• 📎 Multiple Attachments: Send one or many files in a single email
• 👥 CC/BCC Support: Full recipient control with CC and BCC fields
• ✅ Input Validation: Email format validation and file existence checks
• 📝 Detailed Logging: Clear feedback on the email sending process
• ⚙️ Flexible Configuration: External config file for easy customization

🚀 Installation

# Clone the repository
git clone https://github.com/ykRobbyx/secureMailer.git
cd secureMailer

# Install dependencies (if you add any beyond standard library)
# pip install -r requirements.txt

🔧 Configuration

On first run, the script will create a default email_config.ini file. Edit it to include your details:

[EMAIL]
SENDER_EMAIL = youremail@example.com
SMTP_SERVER = smtp.gmail.com
SMTP_PORT = 587
# Optional: starttls or ssl (defaults to ssl on port 465, starttls otherwise)
SMTP_SECURITY = starttls

🖥️ Usage

Command Line Interface

Run the script directly to use the interactive interface:

python secure_mailer.py

The script will guide you through entering:

• Recipient email(s)
• Email subject
• Email body (multi-line supported)
• File attachments (optional)
• Password (securely entered, not displayed)

As a Module

Import and use in your own Python scripts:

from secure_mailer import send_email

success = send_email(
    sender_email="your@email.com",
    password="your_secure_password",  # Consider using environment variables
    receiver_email=["recipient@example.com"],
    subject="Important Update",
    body="Hello, please find the attached documents.",
    attachment_paths=["document1.pdf", "document2.xlsx"],
    cc="manager@example.com",
    bcc=["archive@company.com"]
)

if success:
    print("Email sent successfully!")

Reliable delivery

• Every To, CC, and BCC address is validated before connecting. BCC addresses appear only in the SMTP envelope, never in the message headers.
• Connections verify the server certificate and hostname. Use starttls for port 587 or ssl for implicit TLS on port 465; plaintext mode is not supported.
• All requested attachments must be readable. A missing or unreadable file stops sending instead of silently producing an incomplete email.
• send_email() returns True when the SMTP server accepts all recipients. This does not guarantee inbox delivery. False can mean partial delivery; check the logs before retrying to avoid sending duplicate messages.
• Configuration errors return False from send_email(); load_config() raises ValueError and never terminates the calling process.
• The CLI exits with status 0 on success, 1 on failure, or 130 on cancellation.

Tests

Run the standard-library regression suite (no credentials or real email needed):

python -m unittest discover -s tests -v

📌 Important Notes

• For Gmail users: You'll need to use an App Password instead of your regular account password
• Make sure to add email_config.ini to your .gitignore file to prevent accidentally committing your email configuration

🔒 Security Best Practices

• Never hardcode passwords in your scripts
• Consider using environment variables for sensitive information
• Regularly update your email application passwords
• Use TLS/SSL for secure communication with email servers

🤝 Contributing

Contributions welcome! Feel free to submit pull requests or open issues to improve the functionality.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---