matelabdev-watcher-client 1.0.0

Matelabdev Watcher heartbeat client for Python applications

matelabdev-watcher-client

Python heartbeat client for Matelabdev Watcher.

Install

pip install matelabdev-watcher-client

Usage

from matelabdev_watcher import WatcherClient

watcher = WatcherClient(
    master_url="https://watcher.example.com",
    token="prj_xxxxxxxxxxxx",
    monitor_key="lens-app",
    interval=30,
)
watcher.start()   # daemon thread — stops automatically when process exits

Manual ping

watcher.ping()    # single one-off heartbeat
watcher.stop()    # stop the background thread

Environment variables (recommended)

import os
from matelabdev_watcher import WatcherClient

watcher = WatcherClient(
    master_url=os.environ["WATCHER_URL"],
    token=os.environ["WATCHER_TOKEN"],
    monitor_key=os.environ.get("WATCHER_MONITOR_KEY", "app"),
)
watcher.start()

Behavior

• Heartbeats are fire-and-forget — failures are silently suppressed so your app is never affected.
• The background thread is a daemon, so it exits automatically when the main process ends.
• Calling start() multiple times is safe (idempotent).