Python Error Handling

from devhelm import DevhelmError

try:
    client.monitors.get("nonexistent")
except DevhelmError as e:
    print(e.code)     # "NOT_FOUND"
    print(e.status)   # 404
    print(e.message)  # "Monitor not found"
    print(e.detail)   # optional additional context

from devhelm import AuthError

try:
    client.monitors.list()
except AuthError:
    print("Check your API token")

from devhelm import DevhelmError, AuthError

try:
    monitor = client.monitors.create({
        "name": "API Health",
        "type": "HTTP",
        "config": {"url": "https://api.example.com/health"},
        "frequencySeconds": 60,
    })
except AuthError:
    print("Authentication failed — check your token")
except DevhelmError as e:
    if e.code == "VALIDATION":
        print(f"Invalid request: {e.detail}")
    elif e.code == "CONFLICT":
        print("Resource already exists")
    else:
        print(f"API error ({e.status}): {e.message}")

import time
from devhelm import DevhelmError

def with_retry(fn, max_retries=3):
    for attempt in range(max_retries + 1):
        try:
            return fn()
        except DevhelmError as e:
            if e.status == 429 and attempt < max_retries:
                delay = 2 ** attempt
                time.sleep(delay)
                continue
            raise

monitors = with_retry(client.monitors.list)

from devhelm import DevhelmError

try:
    lock = client.deploy_lock.acquire({
        "lockedBy": "ci-pipeline",
        "ttlMinutes": 30,
    })
except DevhelmError as e:
    if e.code == "CONFLICT":
        current = client.deploy_lock.current()
        if current:
            print(f"Lock held by {current['lockedBy']}")

import httpx
from devhelm import DevhelmError

try:
    client.monitors.list()
except httpx.TimeoutException:
    print("Request timed out")
except httpx.ConnectError:
    print("Could not connect to API")
except DevhelmError as e:
    print(f"API error: {e.message}")