Workspace/session runtime primitives for Hotdata integrations

Navigation

Verified details

These details have been verified by PyPI
Owner

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT
  • Requires: Python >=3.10
Report project as malware

Project description

hotdata-runtime

Shared runtime primitives for Hotdata integrations: workspace/session semantics, execution context, query state, run history, and replayable result handles. Framework packages (Marimo, Jupyter, Streamlit, LangGraph) depend on this package.

Runtime boundary and guarantees are defined in CONTRACT.md.

Features

  • Environment-driven client setup — create clients from HOTDATA_API_KEY, optional HOTDATA_API_URL, HOTDATA_WORKSPACE, and HOTDATA_SANDBOX.
  • Workspace resolution — choose an explicit workspace from env, otherwise discover workspaces and select the active workspace or first available workspace.
  • Sandbox/session propagation — pass sandbox session context through the SDK via X-Session-Id.
  • HTTP resilience — configure SDK retries for transient connection failures and retry SQL execution on stale pooled sockets.
  • SQL execution helper — run SQL through POST /v1/query, poll async query runs when needed, and return a QueryResult.
  • Result utilities — convert query results to records, pandas DataFrames, or metadata dictionaries for adapter display layers.
  • History helpers — list recent results and query run history with normalized dataclasses.
  • Managed databases — create Hotdata-owned catalogs, declare tables, upload parquet, and load managed tables (mirrors hotdata databases in the CLI).
  • Health helpers — build compact API/workspace health summaries for UI integrations.

Install:

uv pip install hotdata-runtime
# or: pip install hotdata-runtime

Example:

python examples/basic_usage.py

Development (uses uv; creates .venv/ in this repo):

uv sync --locked
uv run pytest

uv.lock is checked in so CI can run uv sync --locked. The default dev group (pytest) is enabled via [tool.uv] default-groups.

Project details

Verified details

These details have been verified by PyPI
Owner

Unverified details

These details have not been verified by PyPI
Meta
  • License: MIT
  • Requires: Python >=3.10

Release history Release notifications | RSS feed

This version

0.3.0

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.1

0.1.0

Download files

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

Source Distribution

hotdata_runtime-0.3.0.tar.gz (91.6 kB view details)

Uploaded Source

Built Distribution

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

hotdata_runtime-0.3.0-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file hotdata_runtime-0.3.0.tar.gz.

File metadata

  • Download URL: hotdata_runtime-0.3.0.tar.gz
  • Upload date:
  • Size: 91.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hotdata_runtime-0.3.0.tar.gz
Algorithm Hash digest
SHA256 96807f20df48e727431af96d47b1ec3c19d067a4fdc4ddd746ba6a508202e3af
MD5 30af8ed676b15d678a52e8d2ff71e7cc
BLAKE2b-256 9aa1f5d7d34a646dd3b43f2c7428664f1863714138df59ebe7c7027e69c22194

See more details on using hashes here.

Provenance

The following attestation bundles were made for hotdata_runtime-0.3.0.tar.gz:

Publisher: publish.yml on hotdata-dev/hotdata-runtime

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

File details

Details for the file hotdata_runtime-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for hotdata_runtime-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e546af1652d324b6e6e2832bb2af73b7c639c02670ecc4d34a8c7141fcdc83ac
MD5 56326a84c851940c362d2c0b9ea4fde3
BLAKE2b-256 1cef44a21b447070196c963eb975a6e10c8d90c66f1207328a41c1d36520ab0f

See more details on using hashes here.

Provenance

The following attestation bundles were made for hotdata_runtime-0.3.0-py3-none-any.whl:

Publisher: publish.yml on hotdata-dev/hotdata-runtime

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page