notify-emailer 0.5.0

Send templated error notification emails via SMTP

notify-emailer

Small Python library. Sends HTML error-alert emails through SMTP.

Email includes application name, local timestamp, error message, and error details.

Install

Requires Python 3.9+.

pip install notify-emailer

Or install local checkout:

pip install .

Use

from notify_emailer.config import Config
from notify_emailer.sender import EmailNotifier

config = Config(
    server="smtp.example.com",
    port=25,
    from_addr="[e-mail]",
    to_addr="[e-mail]",
    application="billing-api",
)

notifier = EmailNotifier(config)
notifier.send_error_email(
    error_message="Database connection failed",
    error_details="Timeout while connecting to db.internal:5432",
)

Set custom subject when needed:

config = Config(
    server="smtp.example.com",
    port=25,
    from_addr="[e-mail]",
    to_addr="[e-mail]",
    application="billing-api",
    subject="Billing API error",
)

Config

Field	Meaning
server	SMTP hostname or IP address
port	SMTP port
from_addr	Sender email address
to_addr	Recipient email address
application	Name shown in email
subject	Email subject; default: App Error Notification

SMTP behavior

Uses plain smtplib.SMTP. No authentication, TLS/STARTTLS, or retry logic built in. Configure server/network accordingly, or extend notifier for authenticated/encrypted SMTP.

License

MIT. See LICENSE.