hotdata-framework 0.4.1__tar.gz → 0.6.0__tar.gz

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/CHANGELOG.md

@@ -8,6 +8,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [0.6.0] - 2026-06-30
+
+### Added
+
+- `HotdataClient.add_managed_table(database, table, *, schema)` declares a new table on an existing managed database (wrapping the SDK `add_database_table` endpoint). This allows additive schema evolution without recreating the database.
+
+## [0.5.0] - 2026-06-28
+
+### Changed
+
+- Adopt the `hotdata` 0.5.0 SDK surface (dependency bumped from `>=0.4.1` to `>=0.5.0`). The release is backward compatible for everything the framework uses; the only API changes are additive (a new optional `format` field on `LoadManagedTableRequest` and an optional `format` parameter on `ResultsApi.get_result`), so no framework code changes were required.
 
 ## [0.4.1] - 2026-06-26
 

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hotdata-framework
-Version: 0.4.1
+Version: 0.6.0
 Summary: Python framework for building Hotdata integrations: workspace/session runtime, query execution, and managed databases
 Project-URL: Homepage, https://www.hotdata.dev
 Project-URL: Documentation, https://www.hotdata.dev/docs
@@ -21,7 +21,7 @@ Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: hotdata>=0.4.1
+Requires-Dist: hotdata>=0.5.0
 Requires-Dist: pandas>=2.0
 Requires-Dist: pyarrow>=14.0
 Description-Content-Type: text/markdown

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/hotdata_framework/client.py

@@ -14,6 +14,7 @@ from hotdata.api.query_runs_api import QueryRunsApi
 from hotdata.api.results_api import ResultsApi
 from hotdata.api.uploads_api import UploadsApi
 from hotdata.exceptions import ApiException
+from hotdata.models.add_managed_table_request import AddManagedTableRequest
 from hotdata.models.async_query_response import AsyncQueryResponse
 from hotdata.models.create_database_request import CreateDatabaseRequest
 from hotdata.models.database_default_schema_decl import DatabaseDefaultSchemaDecl
@@ -300,6 +301,33 @@ class HotdataClient:
             full_name=f"{db.id}.{loaded.schema_name}.{loaded.table_name}",
         )
 
+    def add_managed_table(
+        self,
+        database: str,
+        table: str,
+        *,
+        schema: str = DEFAULT_SCHEMA,
+    ) -> ManagedTable:
+        """Declare a new table on an existing managed database.
+
+        The table is added empty (declared-but-unloaded); populate it with
+        :meth:`load_managed_table`. Use this to evolve a managed database's
+        schema after creation without recreating it.
+        """
+        db = self.resolve_managed_database(database)
+        request = AddManagedTableRequest(name=table)
+        try:
+            self._databases_api().add_database_table(db.id, schema, request)
+        except ApiException as e:
+            raise RuntimeError(api_error_message(e)) from e
+        return ManagedTable(
+            full_name=f"{db.id}.{schema}.{table}",
+            schema=schema,
+            table=table,
+            synced=False,
+            last_sync=None,
+        )
+
     def delete_managed_table(
         self,
         database: str,

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hotdata-framework"
-version = "0.4.1"
+version = "0.6.0"
 description = "Python framework for building Hotdata integrations: workspace/session runtime, query execution, and managed databases"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -26,7 +26,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "hotdata>=0.4.1",
+  "hotdata>=0.5.0",
   "pandas>=2.0",
   "pyarrow>=14.0",
 ]

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/tests/test_client.py

@@ -178,6 +178,35 @@ def test_columns_for_qualified_prefers_explicit_connection_id():
     assert fake_api.kwargs["connection_id"] == "conn_explicit"
 
 
+def test_add_managed_table_declares_table_on_existing_database():
+    client = HotdataClient("k", "ws", host="https://api.hotdata.dev")
+    fake_db = SimpleNamespace(id="db_1", default_connection_id="conn")
+
+    class FakeDatabasesApi:
+        def __init__(self):
+            self.calls: list[tuple[str, str, str]] = []
+
+        def add_database_table(self, database_id, var_schema, request):
+            self.calls.append((database_id, var_schema, request.name))
+            return SimpleNamespace(
+                connection_id="conn", var_schema=var_schema, table=request.name
+            )
+
+    fake_api = FakeDatabasesApi()
+    with (
+        patch.object(client, "resolve_managed_database", return_value=fake_db),
+        patch.object(client, "_databases_api", return_value=fake_api),
+    ):
+        result = client.add_managed_table("mydb", "orders", schema="public")
+
+    assert fake_api.calls == [("db_1", "public", "orders")]
+    assert result.full_name == "db_1.public.orders"
+    assert result.schema == "public"
+    assert result.table == "orders"
+    assert result.synced is False
+    assert result.last_sync is None
+
+
 def test_list_recent_results_returns_normalized_summaries():
     client = HotdataClient("k", "ws", host="https://api.hotdata.dev")
     listing = SimpleNamespace(

{hotdata_framework-0.4.1 → hotdata_framework-0.6.0}/uv.lock

@@ -86,7 +86,7 @@ wheels = [
 
 [[package]]
 name = "hotdata"
-version = "0.4.1"
+version = "0.5.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pydantic" },
@@ -94,14 +94,14 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/10/f8/397b2fa161e74abb115283fc169b2abe7455022cc53e1119f0fee80969d2/hotdata-0.4.1.tar.gz", hash = "sha256:e123d267872178f4dd6c8337ac47cf6616984685aca3aaa5ae2c590cecb1f29d", size = 147822, upload-time = "2026-06-19T15:12:36.131Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f2/d8/79f4906f4a39aacd7a94c7991af63064cecb95015d4fbe4d50757b21c940/hotdata-0.5.0.tar.gz", hash = "sha256:3d0240e6a3e7333e4290d8b3e75afebba43e518b868e1c3e3818fd719a6ab994", size = 170462, upload-time = "2026-06-28T16:28:49.591Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/47/59/5ff00a1adce5a8b312692a7145660027340d3b4b352b4c3427045a59191f/hotdata-0.4.1-py3-none-any.whl", hash = "sha256:0a71c3d74bae06a79a05eb3f42893baf33f8229ef6f0dc735b59899048a2b7b1", size = 289951, upload-time = "2026-06-19T15:12:34.752Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/0e/026a2e03647e3d3c26027b690ea24ef036fbeb314b85517db3d606aab4da/hotdata-0.5.0-py3-none-any.whl", hash = "sha256:e7c4f5f8af6a7b370810fb599e5a166fc4bb569f6f41c506698c4bebfb500fcc", size = 286907, upload-time = "2026-06-28T16:28:48.298Z" },
 ]
 
 [[package]]
 name = "hotdata-framework"
-version = "0.4.1"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "hotdata" },
@@ -120,7 +120,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "hotdata", specifier = ">=0.4.1" },
+    { name = "hotdata", specifier = ">=0.5.0" },
     { name = "pandas", specifier = ">=2.0" },
     { name = "pyarrow", specifier = ">=14.0" },
 ]