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
| Option | Default | Notes |
|---|---|---|
flush_at |
20 | Events queued before forced flush |
flush_interval |
5.0 | Periodic flush cadence, seconds |
max_retries |
2 | Per failed batch |
timeout |
5.0 | Per HTTP request, seconds |
max_queue_size |
1000 | Hard cap, raises queue_overflow |
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file getfluxly-0.1.2.tar.gz.
File metadata
- Download URL: getfluxly-0.1.2.tar.gz
- Upload date:
- Size: 11.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
724e28bce98ddec2d7f6487a7ea648644ab6a1a82db45e3b50711c2296e597fb
|
|
| MD5 |
84af6bcad444c38c5a6184e31b342fc9
|
|
| BLAKE2b-256 |
4562de63feab0acd3fc5e5f9a4c17f61ec5c4d4eee0a57546aef1f4b84ef7494
|
Provenance
The following attestation bundles were made for getfluxly-0.1.2.tar.gz:
Publisher:
publish-sdk-python.yml on dineshmiriyala/getfluxly
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
getfluxly-0.1.2.tar.gz -
Subject digest:
724e28bce98ddec2d7f6487a7ea648644ab6a1a82db45e3b50711c2296e597fb - Sigstore transparency entry: 2054361920
- Sigstore integration time:
-
Permalink:
dineshmiriyala/getfluxly@94bdc284980c561de6fb2c977264ad4189269ace -
Branch / Tag:
refs/heads/fix_sdk_flush - Owner: https://github.com/dineshmiriyala
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-sdk-python.yml@94bdc284980c561de6fb2c977264ad4189269ace -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file getfluxly-0.1.2-py3-none-any.whl.
File metadata
- Download URL: getfluxly-0.1.2-py3-none-any.whl
- Upload date:
- Size: 15.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
88e7253b492d84e2321818eb826f807b7af155fba84ea3ab34d90f76c55ed90f
|
|
| MD5 |
712b48cfe40f4a8ab7dd065d207ca404
|
|
| BLAKE2b-256 |
85c5d6f38e87424b260d069acbebea61cdfc7f6daf3766d347670762f22229d6
|
Provenance
The following attestation bundles were made for getfluxly-0.1.2-py3-none-any.whl:
Publisher:
publish-sdk-python.yml on dineshmiriyala/getfluxly
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
getfluxly-0.1.2-py3-none-any.whl -
Subject digest:
88e7253b492d84e2321818eb826f807b7af155fba84ea3ab34d90f76c55ed90f - Sigstore transparency entry: 2054362138
- Sigstore integration time:
-
Permalink:
dineshmiriyala/getfluxly@94bdc284980c561de6fb2c977264ad4189269ace -
Branch / Tag:
refs/heads/fix_sdk_flush - Owner: https://github.com/dineshmiriyala
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-sdk-python.yml@94bdc284980c561de6fb2c977264ad4189269ace -
Trigger Event:
workflow_dispatch
-
Statement type:
