Examples

Examples

The following examples demonstrate how to use the DevNotify SDK in various scenarios.

Sending a Notification

import devnotify
from devnotify import DevNotify

# Quickstart: set your API key
devnotify.api_key = "your_api_key_here"

client = DevNotify()
client.send("Hello from DevNotify!", title="Signup")

Using tags

import devnotify
from devnotify import DevNotify

devnotify.api_key = "your_api_key_here"

client = DevNotify()
client.send(
    "New user signed up",
    title="Signup Event",
    tags=["users", "signup"]
)

Retry failed notifications

import devnotify
from devnotify import DevNotify

devnotify.api_key = "your_api_key_here"

# Customize retries and backoff (default: retries=3, backoff=0.5s)
client = DevNotify(retries=5, backoff=1.0)

client.send("Background sync complete", silent=True)

Handling DevNotify Errors

import devnotify
from devnotify import DevNotify
from devnotify.exceptions import AuthError, RateLimitError, DevNotifyError

devnotify.api_key = "your_api_key_here"
client = DevNotify()

try:
    client.send("Build failed", title="CI/CD")
except AuthError:
    print("Invalid API key — check your dashboard.")
except RateLimitError:
    print("Daily notification limit exceeded.")
except DevNotifyError as e:
    print(f"Unexpected DevNotify error: {e}")
except ServerError as e:
    print(f"Server error occurred: {e}")
except NetworkError as e:
    print(f"Network error occurred: {e}")