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.

Project links

Data verified by PyPI on Jul 9, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for MD_GetFluxly from gravatar.com MD_GetFluxly

Credits

Author: GetFluxly

GitHub Statistics

Data verified by PyPI on Jul 9, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

dev

Tags

analytics cdp events getfluxly telemetry

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getfluxly-0.1.3.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

getfluxly-0.1.3-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file getfluxly-0.1.3.tar.gz.

File metadata

  • Download URL: getfluxly-0.1.3.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for getfluxly-0.1.3.tar.gz
Algorithm Hash digest
SHA256 aace3488f135d76441d061227196ee2a2bf50e0b6e636875f1358ce210f66e58
MD5 8523fd8f9c22324ac8a651a974585bba
BLAKE2b-256 cb654e8d325fbbb4e475f5e8227367b29de7f2ab1ce4214975b4bfa52870577b

See more details on using hashes here.

Provenance

The following attestation bundles were made for getfluxly-0.1.3.tar.gz:

Publisher: publish-sdk-python.yml on dineshmiriyala/getfluxly

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file getfluxly-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: getfluxly-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for getfluxly-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4878e9380938dfe92d112f5d32b5b16af632b0e51c24a9399e467e5dd91660cd
MD5 71bd18396958b6a1e340337ceb9b7645
BLAKE2b-256 360849b0cff0c1949c832a87c0b5e5b9c01992e57626ada85ea3dc31b0498cef

See more details on using hashes here.

Provenance

The following attestation bundles were made for getfluxly-0.1.3-py3-none-any.whl:

Publisher: publish-sdk-python.yml on dineshmiriyala/getfluxly

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.4

2 files

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page