Rename package to hotdata_runtime; uv lock; version metadata and tests.

Eddie A Tejeda · Eddie A Tejeda · commit b34203a72686 · 2026-05-12T22:00:28.000-07:00
diff --git a/README.md b/README.md
@@ -1,16 +1,19 @@
-# hotdata-core-notebook
+# hotdata-runtime
 
-Shared **Hotdata** client and domain types for notebook UIs (Marimo, Jupyter, etc.). UI frameworks depend on this package; they do not belong here.
+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.
 
 Install:
 
 ```bash
-pip install hotdata-core-notebook
+uv pip install hotdata-runtime
+# or: pip install hotdata-runtime
 ```
 
-Development:
+Development (uses **uv**; creates `.venv/` in this repo):
 
 ```bash
-pip install -e ".[dev]"
-pytest
+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`.
diff --git a/hotdata_core_notebook/__init__.py b/hotdata_core_notebook/__init__.py
diff --git a/hotdata_runtime/__init__.py b/hotdata_runtime/__init__.py
@@ -0,0 +1,36 @@
+"""Hotdata runtime primitives for notebook and app integrations."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from hotdata_runtime.client import HotdataClient, from_env
+from hotdata_runtime.health import workspace_health_lines
+from hotdata_runtime.env import (
+    default_api_key,
+    default_host,
+    default_session_id,
+    explicit_workspace_id,
+    list_workspaces,
+    normalize_host,
+    pick_workspace,
+)
+from hotdata_runtime.result import QueryResult
+
+try:
+    __version__ = version("hotdata-runtime")
+except PackageNotFoundError:
+    __version__ = "0.0.0+unknown"
+
+__all__ = [
+    "__version__",
+    "HotdataClient",
+    "QueryResult",
+    "workspace_health_lines",
+    "default_api_key",
+    "default_host",
+    "default_session_id",
+    "explicit_workspace_id",
+    "from_env",
+    "list_workspaces",
+    "normalize_host",
+    "pick_workspace",
+]
diff --git a/hotdata_runtime/client.py b/hotdata_runtime/client.py
@@ -15,14 +15,14 @@
 from hotdata.models.query_response import QueryResponse
 from hotdata.models.table_info import TableInfo
 
-from hotdata_core_notebook.env import (
+from hotdata_runtime.env import (
     default_api_key,
     default_host,
     default_session_id,
     normalize_host,
     pick_workspace,
 )
-from hotdata_core_notebook.result import QueryResult
+from hotdata_runtime.result import QueryResult
 
 _TERMINAL = frozenset({"succeeded", "failed", "cancelled"})
 
diff --git a/hotdata_runtime/env.py b/hotdata_runtime/env.py
diff --git a/hotdata_runtime/health.py b/hotdata_runtime/health.py
@@ -2,7 +2,7 @@
 
 from hotdata.exceptions import ApiException
 
-from hotdata_core_notebook.client import HotdataClient
+from hotdata_runtime.client import HotdataClient
 
 
 def workspace_health_lines(client: HotdataClient) -> tuple[bool, list[str]]:
diff --git a/hotdata_runtime/result.py b/hotdata_runtime/result.py
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,9 +3,9 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "hotdata-core-notebook"
+name = "hotdata-runtime"
 version = "0.1.0"
-description = "Hotdata API client and shared models for notebook integrations"
+description = "Workspace/session runtime primitives for Hotdata integrations"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
@@ -14,13 +14,16 @@ dependencies = [
   "pandas>=2.0",
 ]
 
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
   "pytest>=8.0",
 ]
 
+[tool.uv]
+default-groups = ["dev"]
+
 [tool.hatch.build.targets.wheel]
-packages = ["hotdata_core_notebook"]
+packages = ["hotdata_runtime"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
diff --git a/tests/test_client.py b/tests/test_client.py
@@ -6,8 +6,8 @@
 
 import pytest
 
-from hotdata_core_notebook.env import normalize_host, pick_workspace
-from hotdata_core_notebook.client import HotdataClient
+from hotdata_runtime.env import normalize_host, pick_workspace
+from hotdata_runtime.client import HotdataClient
 
 
 @pytest.mark.parametrize(
@@ -47,7 +47,7 @@ def test_pick_workspace_chooses_first_active(monkeypatch: pytest.MonkeyPatch):
     ]
     listing = SimpleNamespace(workspaces=items)
 
-    with patch("hotdata_core_notebook.env.WorkspacesApi") as Api:
+    with patch("hotdata_runtime.env.WorkspacesApi") as Api:
         Api.return_value.list_workspaces.return_value = listing
         assert pick_workspace("k", "https://api.hotdata.dev", None) == "ws_2"
 
@@ -62,7 +62,7 @@ def test_pick_workspace_falls_back_to_first(monkeypatch: pytest.MonkeyPatch):
     ]
     listing = SimpleNamespace(workspaces=items)
 
-    with patch("hotdata_core_notebook.env.WorkspacesApi") as Api:
+    with patch("hotdata_runtime.env.WorkspacesApi") as Api:
         Api.return_value.list_workspaces.return_value = listing
         assert pick_workspace("k", "https://api.hotdata.dev", None) == "ws_1"
 
diff --git a/tests/test_health.py b/tests/test_health.py
@@ -4,8 +4,8 @@
 
 from hotdata.exceptions import ApiException
 
-from hotdata_core_notebook.client import HotdataClient
-from hotdata_core_notebook.health import workspace_health_lines
+from hotdata_runtime.client import HotdataClient
+from hotdata_runtime.health import workspace_health_lines
 
 
 def test_workspace_health_ok():
diff --git a/tests/test_version.py b/tests/test_version.py
@@ -0,0 +1,13 @@
+import re
+
+from importlib.metadata import version as dist_version
+
+import hotdata_runtime as hr
+
+
+def test_version_is_pep440_core():
+    assert re.fullmatch(r"\d+\.\d+\.\d+(\+.*)?", hr.__version__)
+
+
+def test_version_matches_distribution_metadata():
+    assert dist_version("hotdata-runtime") == hr.__version__
diff --git a/uv.lock b/uv.lock
