Lunchable Push Lunch

raw JSON →

1.4.0 verified Fri May 01 auth: no python

LunchMoney Push Notifications via Pushover and ntfy. Current version 1.4.0. Released semi-annually.

pip install lunchable-pushlunch

Common errors

error ModuleNotFoundError: No module named 'lunchable_pushlunch' ↓

cause Typo or using hyphens instead of underscores in import statement.

fix

pip install lunchable-pushlunch; then import: from lunchable_pushlunch import Pushlunch

error lunchable.exceptions.LunchMoneyError: Invalid access token ↓

cause Missing or invalid LUNCHMONEY_TOKEN environment variable.

fix

Set LUNCHMONEY_TOKEN to your LunchMoney API key (from https://lunchmoney.dev/).

error Exception: Pushover user key and API token are required ↓

cause Missing Pushover credentials.

fix

Set PUSHOVER_USER_KEY and PUSHOVER_API_TOKEN environment variables.

Warnings

gotcha The library requires both Pushover user key AND API token. Missing one will fail silently or raise an error. ↓

fix Set all three env vars: LUNCHMONEY_TOKEN, PUSHOVER_USER_KEY, PUSHOVER_API_TOKEN.

deprecated Pushover is the default provider; ntfy support is experimental (v1.4.0). Future versions may change the API. ↓

fix Check the README for ntfy configuration specifics.

gotcha The package uses underscore in import path (lunchable_pushlunch), not hyphen (lunchable-pushlunch). ↓

fix Use `from lunchable_pushlunch import Pushlunch`.

Imports

Pushlunch

from lunchable_pushlunch import Pushlunch

Quickstart

Basic usage to send a Pushover notification.

import os
from lunchable_pushlunch import Pushlunch

# Configure via environment variables or constructor args
client = Pushlunch(
    lunchmoney_token=os.environ.get("LUNCHMONEY_TOKEN", ""),
    pushover_user_key=os.environ.get("PUSHOVER_USER_KEY", ""),
    pushover_api_token=os.environ.get("PUSHOVER_API_TOKEN", ""),
)

# Send a notification
client.notify("Test notification from Pushlunch")