drpython 0.3.1

Modular notifications: drpython.telegram, drpython.email & drpython.database

drpython

Modular notifications for Python projects: simple helpers for Telegram bots and SMTP email.

This library provides three utilities:

• drpython.telegram: send messages via a Telegram bot.
• drpython.email: send emails via an SMTP server.
• drpython.database: append-friendly helpers for CSV, Excel (.xlsx), and JSON.

Both modules expose a light class (TelegramNotifier, EmailNotifier) and a convenience function (notify_telegram, notify_email).

Installation

• Using uv (recommended for projects):

  uv add drpython
  

• Using pip:

  pip install drpython
  

Quickstart

You can pass credentials directly to the functions/classes, or supply them via environment variables. If you keep secrets in a .env file, load it with python-dotenv before calling the notifiers.

from dotenv import load_dotenv
load_dotenv()  # Only needed if using a .env file

Telegram

Environment variables used:

• DRPYTHON_TELEGRAM_TOKEN
• DRPYTHON_CHAT_ID

Send a Telegram message using environment variables:

from drpython.telegram import notify_telegram

ok = notify_telegram("Hello from drpython!", parse_mode="HTML")
print(ok)  # True if sent

Or pass credentials explicitly:

from drpython.telegram import TelegramNotifier

bot = TelegramNotifier(token="<BOT_TOKEN>", chat_id="<CHAT_ID>")
ok = bot.send("<b>Bold</b> and <i>italic</i>", parse_mode="HTML", disable_notification=False)
print(ok)

Email (SMTP)

Environment variables used:

• DRPYTHON_SMTP_HOST (e.g., smtp.gmail.com)
• DRPYTHON_SMTP_PORT (default 587)
• DRPYTHON_SMTP_USER
• DRPYTHON_SMTP_PASSWORD
• DRPYTHON_SMTP_FROM (defaults to user)

Send an email using environment variables:

from drpython.email import notify_email

ok = notify_email(
    to="[e-mail]",
    subject="Greetings",
    body="Hello from drpython!",
    html=False,  # set True to send HTML
)
print(ok)

Database (CSV, Excel, JSON)

Convenience functions to append or create tabular data files from a list of dictionaries. Dependencies pandas and openpyxl are included.

Functions:

• add_to_csv(data, filename, *, encoding='utf-8', index=False, append=True, **kwargs)
• add_to_excel(data, filename, *, sheet_name='Sheet1', index=False, append=True, **kwargs)
• add_to_json(data, filename, *, append=True, indent=2, **kwargs)

Example:

from drpython.database import add_to_csv, add_to_excel, add_to_json

data = [
    {"id": 1, "name": "Alice", "score": 95},
    {"id": 2, "name": "Bob",   "score": 87},
]

# CSV: appends if file exists, otherwise creates; controls header/index
add_to_csv(data, "users.csv", append=True, index=False)

# Excel (.xlsx): appends to an existing sheet starting at next row; creates otherwise
add_to_excel(data, "users.xlsx", sheet_name="Users", append=True, index=False)

# JSON: writes a proper JSON array; appends safely if file exists and is valid JSON
add_to_json(data, "users.json", append=True, indent=2)

Or pass credentials explicitly and use the class:

from drpython.email import EmailNotifier

mailer = EmailNotifier(
    host="smtp.example.com",
    port=587,
    user="[e-mail]",
    password="app_password",
    from_addr="[e-mail]",
)

ok = mailer.send(
    to=["[e-mail]", "[e-mail]"],
    subject="Attachments and HTML",
    body="<b>Hello</b> world",
    html=True,
    cc="[e-mail]",
    bcc=["[e-mail]", "[e-mail]"],
    attachments=["path/to/file.pdf"],
)
print(ok)

Using .env

If you prefer a .env file, create it and load it in your app:

# Telegram
DRPYTHON_TELEGRAM_TOKEN=your-bot-token
DRPYTHON_CHAT_ID=your-chat-id

# SMTP
DRPYTHON_SMTP_HOST=smtp.example.com
DRPYTHON_SMTP_PORT=587
DRPYTHON_SMTP_USER=[e-mail]
DRPYTHON_SMTP_PASSWORD=app_password
DRPYTHON_SMTP_FROM=[e-mail]

Then load it:

from dotenv import load_dotenv
load_dotenv()

Never commit real tokens or passwords to source control.

Notes

• Commands above are shown for Windows PowerShell.
• notify_telegram uses requests.get and returns True/False based on Telegram API response.
• notify_email uses smtplib.SMTP and returns True/False based on send success.
• Data helpers rely on pandas (and openpyxl for Excel) which are installed automatically.
• If you encounter build/publish issues, ensure your pyproject.toml includes a src/drpython wheel target and excludes .env from distributions.