MeasureBot

Simple bot for notifications via Discord and email.

Setup

1. Install dependencies:

   pip install requests

2. Configure:

   cp .env.example .env
   # Edit .env with your credentials

3. Run:

   python measurebot/alerts.py

Usage

IPython/Jupyter Setup (Recommended)

# Set up defaults once per session
from measurebot.alerts import set_defaults, discord, email, alert

set_defaults(
    discord_user="asharpe",      # Discord user for DMs
    email_user="aaron"           # Email recipient
)

# Now use short, simple calls
discord("Sample is ready!")                    # Sends DM
email("Sample is ready!", "Lab Alert")        # Sends email
alert("Critical: Temperature high!")          # Sends both DM + email

Full Function Calls

from measurebot.alerts import send_discord_message, send_email

# Send Discord DM (default behavior)
send_discord_message("System alert!", user="asharpe")

# Send email to specific user
send_email("Important notification", subject="Alert", to_user="aaron")

# Send to Discord channel (if you still need channels)
from measurebot.alerts import discord_channel
discord_channel("Public announcement", channel="alerts", user="asharpe")

Configuration

Edit .env file:

# Discord (optional)
DISCORD_BOT_TOKEN=your-bot-token
DISCORD_USER_ASHARPE=user-id

# Email (required for email notifications)
SMTP_PASS=your-resend-api-key
EMAIL_FROM=sender@yourdomain.com

# Email recipients (choose one method)
EMAIL_TO=default@example.com              # Default recipient
# OR use named recipients:
EMAIL_TO_AARON=aaron@example.com          # Send to specific users
EMAIL_TO_ADMIN=admin@example.com

That's it!