Add Prowl notification support and update README (#10)

* Add Prowl notification support and update README

* Fix syntax error by adding a missing comma in notifications import

Author: lczerepuk

.env.example

@@ -5,3 +5,4 @@ GOTIFY_TOKEN=mytoken
 GOTIFY_HOST=https://mygotify_server.com
 NOTIFIERS_TELEGRAM_CHAT_ID=-21xxxxx38
 NOTIFIERS_TELEGRAM_TOKEN=63xxxxxx71:AAFoxxxxn0hwA-2TVSxxxNf4c
+NOTIFIERS_PROWL_API_KEY=xxx

README.md

@@ -15,7 +15,7 @@ The application is designed to be run in a Docker container and includes a `ttyd
 
 - Search for appointments by region, specialty, clinic, doctor, date range, and language at a configurable interval.
 - Handles Multi-Factor Authentication (MFA).
-- Sends notifications via Gotify, Telegram, Pushbullet, Pushover, and XMPP.
+- Sends notifications via Gotify, Telegram, Pushbullet, Pushover, Prowl and XMPP.
 - Remote management through an integrated `ttyd` web terminal.
 - Persistent data storage for sessions, tokens, and logs.
 - Bullet proof design - created for long runs.
@@ -180,6 +180,10 @@ Add the required environment variables for your preferred service to the `.env`
 
 - `NOTIFIERS_PUSHBULLET_TOKEN`: Your access token.
 
+### Prowl
+
+- `NOTIFIERS_PROWL_API_KEY`: Your API key.
+
 ### XMPP (Jabber)
 
 - `NOTIFIERS_XMPP_JID`: Your full JID (`user@example.com`).

medichaser.py

@@ -57,6 +57,7 @@
 
 from notifications import (
     gotify_notify,
+    prowl_notify,
     pushbullet_notify,
     pushover_notify,
     telegram_notify,
@@ -910,6 +911,8 @@ def send_notification(
             xmpp_notify(message)
         elif notifier == "gotify":
             gotify_notify(message, title)
+        elif notifier == "prowl":
+            prowl_notify(message, title)
         log.info("Notification sent successfully.")
 
 

notifications.py

@@ -27,6 +27,26 @@
 pushover = get_notifier("pushover")
 telegram = get_notifier("telegram")
 
+def prowl_notify(message: str, title: str | None = None) -> None:
+    if not environ.get("NOTIFIERS_PROWL_API_KEY"):
+        print(
+            "Prowl notifications require NOTIFIERS_PROWL_API_KEY environment to be exported.",
+        )
+        return
+
+    url = "https://api.prowlapp.com/publicapi/add"
+    payload = {
+        "apikey": environ.get("NOTIFIERS_PROWL_API_KEY", ""),
+        "priority": -1,
+        "application": title or "MediChaser",
+        "event": "Alert",
+        "description": message,
+    }
+    try:
+        response = requests.post(url=url, data=payload, timeout=3)
+        response.raise_for_status()
+    except requests.exceptions.RequestException as e:
+        print(f"Prowl notification failed:\n{e}")
 
 def pushbullet_notify(message: str, title: str | None = None) -> None:
     try: