notifox 0.1.1

Official Python SDK for Notifox alerting API

notifox-py

Python SDK for Notifox.

Installation

pip install notifox

Usage

from notifox import NotifoxClient

client = NotifoxClient(api_key="your_api_key_here")
client.send_alert(audience="mike", alert="Database server is down!")

Or use the environment variable:

export NOTIFOX_API_KEY="your_api_key_here"

client = NotifoxClient()  # Reads from NOTIFOX_API_KEY
client.send_alert(audience="mike", alert="High CPU usage!")

Configuration

client = NotifoxClient(
    api_key="your_api_key",
    base_url="https://api.notifox.com",
    timeout=30.0,
    max_retries=3
)

Error Handling

from notifox import (
    NotifoxClient,
    NotifoxAuthenticationError,
    NotifoxRateLimitError,
    NotifoxAPIError,
    NotifoxConnectionError
)

client = NotifoxClient(api_key="your_api_key")

try:
    client.send_alert(audience="admin", alert="System is running low on memory")
except NotifoxAuthenticationError:
    print("Authentication failed. Check your API key.")
except NotifoxRateLimitError:
    print("Rate limit exceeded. Please wait before sending more alerts.")
except NotifoxAPIError as e:
    print(f"API error ({e.status_code}): {e.response_text}")
except NotifoxConnectionError as e:
    print(f"Connection failed: {e}")

Available exceptions:

• NotifoxError - Base exception
• NotifoxAuthenticationError - Authentication failed (401/403)
• NotifoxRateLimitError - Rate limit exceeded (429)
• NotifoxAPIError - General API errors
• NotifoxConnectionError - Network errors