email_tool.py

import smtplib
import logging
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from config import SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, EMAIL_FROM


def send_email(
    subject: str,
    body: str,
    recipients: str,
    cc: str = "",
    html: bool = False
) -> str:
    """
    Sends an email via SMTP.

    Args:
        subject: Email subject line
        body: Email body (plain text or HTML)
        recipients: Comma-separated To addresses
        cc: Comma-separated CC addresses (optional)
        html: If True, sends body as HTML. Default is plain text.

    Returns:
        Success or error message string.
    """
    content_type = "html" if html else "plain"

    try:
        msg = MIMEMultipart()
        msg["From"] = EMAIL_FROM
        msg["To"] = recipients
        if cc:
            msg["Cc"] = cc
        msg["Subject"] = subject
        msg.attach(MIMEText(body, content_type))

        all_recipients = [r.strip() for r in recipients.split(",") if r.strip()]
        if cc:
            all_recipients += [r.strip() for r in cc.split(",") if r.strip()]

        with smtplib.SMTP(SMTP_HOST, SMTP_PORT) as server:
            server.ehlo()
            server.starttls()
            server.login(SMTP_USER, SMTP_PASSWORD)
            server.sendmail(EMAIL_FROM, all_recipients, msg.as_string())

        result = f"Email sent to {recipients}" + (f", CC {cc}" if cc else "")
        logging.info(f"[EMAIL] SUCCESS | to={recipients} | subject={subject}")
        return result

    except Exception as e:
        error = f"ERROR sending email: {e}"
        logging.error(f"[EMAIL] FAILED | to={recipients} | subject={subject} | error={e}")
        return error