pyxpo-notifications

Local notifications for pyxpo apps. The API follows expo-notifications. iOS uses UserNotifications. Android posts with NotificationManager and schedules with AlarmManager (no Firebase); scheduled notifications are set again after a reboot or an app update.

pip install pyxpo-notifications

[tool.pyxpo]
modules = ["notifications"]

# Optional: exact timing on Android 12+. Without it Android may show a scheduled notification a little late.
[tool.pyxpo.android]
permissions = ["android.permission.SCHEDULE_EXACT_ALARM"]

import pyxpo_notifications as Notifications

# Show notifications while the app is open too (without a handler they show only in the background).
Notifications.set_notification_handler({
    "handle_notification": lambda n: {"should_show_banner": True, "should_show_list": True,
                                      "should_play_sound": True, "should_set_badge": False},
})

perm = await Notifications.request_permissions_async()
if perm["granted"]:
    await Notifications.schedule_notification_async({
        "content": {"title": "Tea", "body": "Your tea is ready", "data": {"cup": 2}},
        "trigger": {"type": Notifications.SchedulableTriggerInputTypes.TIME_INTERVAL, "seconds": 180},
    })

sub = Notifications.add_notification_response_received_listener(
    lambda r: print("tapped", r["notification"]["request"]["content"]["data"]))

Functions

Notification content: title, subtitle, body, data (a JSON-compatible dict), badge, sound (True for the default sound); Android also sticky, auto_dismiss, priority, color; iOS interruption_level. Android shows a notification on trigger["channel_id"], else on a default channel.

Triggers (SchedulableTriggerInputTypes):

Times are local. camelCase names work too (scheduleNotificationAsync, {"channelId": "alerts"}).

Not supported yet

• Remote push: get_device_push_token_async, get_expo_push_token_async and add_push_token_listener raise NotSupportedError (they need Firebase on Android and an APNs AppDelegate hook on iOS). A remote notification that arrives on iOS still reaches the listeners.
• Categories and action buttons, attachments, custom sounds.

Notes

• iOS: the Simulator cannot pre-grant notifications; allow_provisional gives quiet notifications without a prompt.
• Android 13+: the system prompt needs POST_NOTIFICATIONS (added by this package). Without the permission the system drops notifications silently.
• Android: a notification fired while the app is open goes to Python first; with no handler it is not shown.