getfluxly (Python)

Server-side Python SDK for GetFluxly. Same surface as the Node SDK so observability across SDKs lives in one mental model.

pip install getfluxly

Quick start (sync)

from getfluxly import Client

client = Client(token="gflux_secret_yourtoken")

client.track("subscription_started",
             external_id="user_42",
             properties={"plan": "pro"})

client.identify(external_id="user_42",
                traits={"email": "x@y.com", "plan": "pro"})

client.alias(user_id="user_42", anonymous_id="anon_a8f3c2")

client.flush()
client.shutdown()  # also runs from atexit

Quick start (async)

from getfluxly import AsyncClient

async with AsyncClient(token="gflux_secret_yourtoken") as ac:
    await ac.track("subscription_started",
                   external_id="user_42",
                   properties={"plan": "pro"})

Defaults

Retries: 408, 425, 429, and 5xx with exponential backoff and +/- 25% jitter. Retry-After is honored. Each batch carries a unique X-Idempotency-Key. Each individual event also carries a stable message_id (UUID v4) generated when the payload is built — the backend uses (project_id, message_id) to deduplicate duplicate deliveries across retries.

Errors

from getfluxly import GFluxError

try:
    client.track("invoice_paid", external_id="user_42")
except GFluxError as e:
    if e.code == "queue_overflow":
        ...  # back-pressure
    elif e.retryable:
        ...  # SDK already retried max_retries times

Full code table at docs.getfluxly.com/snippets/error-table.

Server keys never in browser

Client(token="gflux_secret_...") refuses to construct if it detects a Pyodide / Emscripten runtime, so a server-side script that accidentally ships to the browser fails loudly instead of leaking the key into client traffic.

License

MIT, see LICENSE.