hotdata-runtime 0.2.0__tar.gz → 0.2.2__tar.gz

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/.github/workflows/release.yml

@@ -45,7 +45,7 @@ jobs:
           } >> "$GITHUB_OUTPUT"
 
       - name: Create GitHub Release
-        uses: softprops/action-gh-release@1e812e8210a4a8a0b23075e5795f2a4e2b2a0b7 # v2.2.2
+        uses: softprops/action-gh-release@da05d552573ad5aba039eaac05058a918a7bf631 # v2.2.2
         with:
           tag_name: ${{ github.ref_name }}
           name: ${{ steps.meta.outputs.name }} ${{ steps.meta.outputs.version }}

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+
+
+## [0.2.2] - 2026-05-27
+
+### Changed
+
+- Release 0.2.2
+
+## [0.2.1] - 2026-05-24
+
+### Added
+
+- `execute_sql` accepts an optional `database` keyword argument. When provided, the database name is resolved to an ID and sent as the `X-Database-Id` header so SQL can reference managed database tables as `"default"."<schema>"."<table>"`. Behaviour is unchanged when `database` is omitted.
+
 ## [0.2.0] - 2026-05-24
 
 ### Changed

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: hotdata-runtime
-Version: 0.2.0
+Version: 0.2.2
 Summary: Workspace/session runtime primitives for Hotdata integrations
 License: MIT
 Requires-Python: >=3.10
-Requires-Dist: hotdata>=0.2.3
+Requires-Dist: hotdata>=0.2.4
 Requires-Dist: pandas>=2.0
 Description-Content-Type: text/markdown
 

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/hotdata_runtime/client.py

@@ -180,7 +180,7 @@ class HotdataClient:
         listing = self._databases_api().list_databases()
         match_id: str | None = None
         for db in listing.databases:
-            if db.description == name_or_id:
+            if db.name == name_or_id:
                 match_id = db.id
                 break
         if match_id is None:
@@ -208,7 +208,7 @@ class HotdataClient:
                 )
             ]
         request = CreateDatabaseRequest(
-            description=description,
+            name=description,
             schemas=schemas,
             expires_at=expires_at,
         )
@@ -475,11 +475,20 @@ class HotdataClient:
             f"(last status: {getattr(last, 'status', None)})"
         )
 
-    def execute_sql(self, sql: str) -> QueryResult:
+    def execute_sql(self, sql: str, *, database: str | None = None) -> QueryResult:
+        """Execute SQL and return a :class:`QueryResult`.
+
+        Pass ``database`` to scope the query to a managed database.  The name
+        is resolved to a database ID once before the retry loop, and the
+        ``X-Database-Id`` header is sent with every attempt.  Inside a managed
+        database the built-in catalog is always ``"default"``, so table
+        references should use ``"default"."<schema>"."<table>"``.
+        """
+        database_id = self.resolve_managed_database(database).id if database else None
         last_err: BaseException | None = None
         for attempt in range(3):
             try:
-                return self._execute_sql_once(sql)
+                return self._execute_sql_once(sql, database_id=database_id)
             except (ProtocolError, ConnectionResetError, Urllib3HTTPError) as e:
                 last_err = e
                 if attempt == 2:
@@ -487,10 +496,13 @@ class HotdataClient:
                 time.sleep(0.2 * (2**attempt))
         raise last_err  # pragma: no cover
 
-    def _execute_sql_once(self, sql: str) -> QueryResult:
+    def _execute_sql_once(self, sql: str, *, database_id: str | None = None) -> QueryResult:
         q = self._query_api()
         try:
-            raw = q.query(QueryRequest(sql=sql))
+            if database_id:
+                raw = q.query(QueryRequest(sql=sql), x_database_id=database_id)
+            else:
+                raw = q.query(QueryRequest(sql=sql))
         except ApiException as e:
             raise RuntimeError(e.reason or str(e)) from e
 

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/hotdata_runtime/databases.py

@@ -52,7 +52,7 @@ def is_parquet_path(path: str) -> bool:
 def managed_database_from_detail(detail: Any) -> ManagedDatabase:
     return ManagedDatabase(
         id=str(detail.id),
-        description=detail.description,
+        description=detail.name,
         default_connection_id=str(detail.default_connection_id),
     )
 

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hotdata-runtime"
-version = "0.2.0"
+version = "0.2.2"
 description = "Workspace/session runtime primitives for Hotdata integrations"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "MIT" }
 dependencies = [
-  "hotdata>=0.2.3",
+  "hotdata>=0.2.4",
   "pandas>=2.0",
 ]
 

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/tests/test_client.py

@@ -200,6 +200,67 @@ def test_list_recent_results_returns_normalized_summaries():
     assert out[0].to_dict()["created_at"] == "2026-01-01T00:00:00Z"
 
 
+def test_execute_sql_sends_no_database_id_by_default():
+    from hotdata.models.query_response import QueryResponse as _QR
+
+    client = HotdataClient("k", "ws", host="https://api.hotdata.dev")
+
+    class FakeQueryApi:
+        def __init__(self):
+            self.calls: list[dict] = []
+
+        def query(self, request, **kwargs):
+            self.calls.append(kwargs)
+            return _QR(
+                columns=["n"],
+                rows=[[1]],
+                row_count=1,
+                nullable=[False],
+                result_id="res_1",
+                query_run_id="qrun_1",
+                execution_time_ms=1,
+            )
+
+    fake_q = FakeQueryApi()
+    with patch.object(client, "_query_api", return_value=fake_q):
+        client.execute_sql("SELECT 1")
+
+    assert fake_q.calls == [{}]
+
+
+def test_execute_sql_resolves_database_and_sends_x_database_id():
+    from hotdata.models.query_response import QueryResponse as _QR
+    from types import SimpleNamespace
+
+    client = HotdataClient("k", "ws", host="https://api.hotdata.dev")
+
+    class FakeQueryApi:
+        def __init__(self):
+            self.calls: list[dict] = []
+
+        def query(self, request, **kwargs):
+            self.calls.append(kwargs)
+            return _QR(
+                columns=["n"],
+                rows=[[1]],
+                row_count=1,
+                nullable=[False],
+                result_id="res_1",
+                query_run_id="qrun_1",
+                execution_time_ms=1,
+            )
+
+    fake_q = FakeQueryApi()
+    fake_db = SimpleNamespace(id="db_abc")
+
+    with patch.object(client, "_query_api", return_value=fake_q), \
+         patch.object(client, "resolve_managed_database", return_value=fake_db) as resolve:
+        client.execute_sql('SELECT * FROM "default"."public"."orders"', database="my_db")
+
+    resolve.assert_called_once_with("my_db")
+    assert fake_q.calls == [{"x_database_id": "db_abc"}]
+
+
 def test_list_run_history_returns_normalized_items():
     client = HotdataClient("k", "ws", host="https://api.hotdata.dev")
     listing = SimpleNamespace(

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/tests/test_databases.py

@@ -20,7 +20,7 @@ def _client() -> HotdataClient:
 def _detail(id="db_1", description="sales", default_connection_id="conn_1"):
     return SimpleNamespace(
         id=id,
-        description=description,
+        name=description,
         default_connection_id=default_connection_id,
     )
 
@@ -86,7 +86,7 @@ def test_resolve_managed_database_by_id():
 
 def test_resolve_managed_database_by_description():
     client = _client()
-    summary = SimpleNamespace(id="db_1", description="sales")
+    summary = SimpleNamespace(id="db_1", name="sales")
     listing = SimpleNamespace(databases=[summary])
     detail = _detail()
     with patch.object(client, "_databases_api") as dbs:

{hotdata_runtime-0.2.0 → hotdata_runtime-0.2.2}/uv.lock

@@ -43,7 +43,7 @@ wheels = [
 
 [[package]]
 name = "hotdata"
-version = "0.2.3"
+version = "0.2.4"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
@@ -51,14 +51,14 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4f/20/5d016d4aec39fe04eb77a6394651e3b18f6ecc701dc678563889debd79ed/hotdata-0.2.3.tar.gz", hash = "sha256:bc415af4ac475e5bd5fe3320d1c14aaac92942462a0ef9dac22b89bcc120ad55", size = 118187, upload-time = "2026-05-23T04:41:10.835Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/31/4b13883c5b3bc50892210dc1e3cac71b5bb08d352e70ac557c78383c1e9e/hotdata-0.2.4.tar.gz", hash = "sha256:7fc64448eaf65b822b50249c51350bf5ec05edd03c611b92ce881a495ae336ab", size = 121635, upload-time = "2026-05-27T22:05:28.424Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/09/87/d3cb845ba01e5b4e9bfb1e59d0032a246b94497e470d171f2ee2a56bd850/hotdata-0.2.3-py3-none-any.whl", hash = "sha256:aed2ae884d184cf143572c84d068a9ceedbe021a6d14005332647a46aa7be11c", size = 275718, upload-time = "2026-05-23T04:41:09.355Z" },
+    { url = "https://files.pythonhosted.org/packages/20/cb/fb9e48af1d105ff18b0732bc87e552a32f4d816ab50c093d901f9fe7e8cd/hotdata-0.2.4-py3-none-any.whl", hash = "sha256:e6652ee2f88bc214938784747e3f644a4ecc4987f9887d302ca3b8940fc52028", size = 285813, upload-time = "2026-05-27T22:05:26.766Z" },
 ]
 
 [[package]]
 name = "hotdata-runtime"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "hotdata" },
@@ -74,7 +74,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "hotdata", specifier = ">=0.2.3" },
+    { name = "hotdata", specifier = ">=0.2.4" },
     { name = "pandas", specifier = ">=2.0" },
 ]