simple-smtp-sender 0.1.0

A Simple SMTP Email Sender, powered by PyO3

simple_smtp_sender

A Simple SMTP Email Sender, powered by Rust and PyO3.

Overview

This project provides a Python extension module implemented in Rust for sending emails via SMTP, including support for attachments, CC, and BCC. It leverages the performance and safety of Rust, exposes a convenient Python API, and is built using PyO3 and lettre.

Features

• Send emails via SMTP from Python
• Support HTML email contents
• Attach files to emails
• Support for CC and BCC
• Secure authentication
• Easy configuration via Python class

Installation

from PyPI

pip install simple_smtp_sender

from source (requires Rust toolchain and maturin)

git clone https://github.com/guangyu-he/simple_smtp_sender.git
cd simple_smtp_sender
# prepare venv and maturin if needed
maturin build

Requirements

• Python >= 3.10
• Rust toolchain (for building)

Usage

from simple_smtp_sender import EmailConfig, send_email

config = EmailConfig(
    server="smtp.example.com",
    sender_email="[e-mail]",
    username="your_username",
    password="your_password",
)

send_email(
    config,
    recipient="[e-mail]",
    subject="Test Email",
    body="Hello from Rust!",
)

# With attachment, CC, and BCC:
send_email(
    config,
    recipient="[e-mail]",
    subject="With Attachment",
    body="See attached file.",
    cc="[e-mail]",
    bcc="[e-mail]",
    attachment="/path/to/file.pdf",
)

API

EmailConfig

Configuration class for SMTP server and credentials.

• server: SMTP server URL
• sender_email: Sender's email address
• username: SMTP username
• password: SMTP password

send_email(config, recipient, subject, body, cc=None, bcc=None, attachment=None)

Sends an email using the provided configuration.

• config: EmailConfig instance
• recipient: Recipient's email
• subject: Email subject
• body: Email body
• cc: CC recipient (optional)
• bcc: BCC recipient (optional)
• attachment: Path to file to attach (optional)

Development

• Rust dependencies are managed in Cargo.toml.
• Python build configuration is in pyproject.toml.
• Main Rust logic in src/.

License

MIT