hotdata 0.10.0__tar.gz → 0.12.0__tar.gz

{hotdata-0.10.0 → hotdata-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hotdata
-Version: 0.10.0
+Version: 0.12.0
 Summary: Hotdata API
 Author-email: Hotdata <developers@hotdata.dev>
 License: MIT
@@ -9,7 +9,7 @@ Project-URL: Repository, https://github.com/hotdata-dev/sdk-python
 Keywords: hotdata,api-client,data-platform
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: urllib3<3.0.0,>=2.7.0
+Requires-Dist: urllib3<3.0.0,>=2.8.0
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: pydantic>=2.4.0
 Requires-Dist: typing-extensions>=4.7.1
@@ -18,7 +18,7 @@ Requires-Dist: pyarrow>=14.0.1; extra == "arrow"
 
 # hotdata
 
-Official Python client for the [Hotdata](https://www.hotdata.dev) HTTP API: workspaces, connections, datasets, SQL queries, results, secrets, uploads, indexes, jobs, embedding providers, and workspace context.
+Official Python client for the [Hotdata](https://www.hotdata.dev) HTTP API: workspaces, connections, instant databases, SQL queries, results, uploads, indexes, jobs, embedding providers, and database context.
 
 ## Requirements
 
@@ -55,7 +55,17 @@ configuration = hotdata.Configuration(
 )
 ```
 
-`host` defaults to `https://api.hotdata.dev`. Override it if you target another environment.
+Each of these can come from the environment instead, the same variables the
+CLI uses: `HOTDATA_API_KEY`, `HOTDATA_WORKSPACE` and `HOTDATA_API_URL` fill in
+`api_key`, `workspace_id` and `host` when the argument is not passed. An
+explicit argument always wins.
+
+`host` defaults to `https://api.hotdata.dev`. Override it (or set
+`HOTDATA_API_URL`) if you target another environment.
+
+Almost every call is workspace-scoped. If no workspace id is configured, the
+SDK raises `hotdata.MissingWorkspaceError` before sending the request rather
+than letting the server answer with an unexplained 404.
 
 ## Usage
 
@@ -78,6 +88,25 @@ with hotdata.ApiClient(configuration) as api_client:
 
 Each `Api` class groups endpoints by resource. Construct the client, then call the typed methods you need.
 
+## Loading tables
+
+Loads are serialised per table on the server. `hotdata.DatabasesApi` and
+`hotdata.ConnectionsApi` retry a load that hits a table another load still
+holds (HTTP 409, error code `RESOURCE_LOCKED`), honouring the server's
+`Retry-After`, for up to 60s by default:
+
+```python
+from hotdata import DatabasesApi, LoadRetryPolicy, TableLockedError
+
+databases = DatabasesApi(api_client, load_retry=LoadRetryPolicy(deadline_s=120))
+try:
+    databases.load_database_table(db_id, "public", "events", request)
+except TableLockedError as e:
+    print(f"gave up after {e.attempts} attempts: {e.reason}")
+```
+
+Other 409s (`CONFLICT`, `IDEMPOTENCY_KEY_CONFLICT`) are raised immediately.
+
 ## Arrow results
 
 Query results can be fetched as an [Apache Arrow](https://arrow.apache.org/) IPC stream instead of JSON, which is faster and far more memory-efficient for large result sets. Install the optional extra:

{hotdata-0.10.0 → hotdata-0.12.0}/README.md

@@ -1,6 +1,6 @@
 # hotdata
 
-Official Python client for the [Hotdata](https://www.hotdata.dev) HTTP API: workspaces, connections, datasets, SQL queries, results, secrets, uploads, indexes, jobs, embedding providers, and workspace context.
+Official Python client for the [Hotdata](https://www.hotdata.dev) HTTP API: workspaces, connections, instant databases, SQL queries, results, uploads, indexes, jobs, embedding providers, and database context.
 
 ## Requirements
 
@@ -37,7 +37,17 @@ configuration = hotdata.Configuration(
 )
 ```
 
-`host` defaults to `https://api.hotdata.dev`. Override it if you target another environment.
+Each of these can come from the environment instead, the same variables the
+CLI uses: `HOTDATA_API_KEY`, `HOTDATA_WORKSPACE` and `HOTDATA_API_URL` fill in
+`api_key`, `workspace_id` and `host` when the argument is not passed. An
+explicit argument always wins.
+
+`host` defaults to `https://api.hotdata.dev`. Override it (or set
+`HOTDATA_API_URL`) if you target another environment.
+
+Almost every call is workspace-scoped. If no workspace id is configured, the
+SDK raises `hotdata.MissingWorkspaceError` before sending the request rather
+than letting the server answer with an unexplained 404.
 
 ## Usage
 
@@ -60,6 +70,25 @@ with hotdata.ApiClient(configuration) as api_client:
 
 Each `Api` class groups endpoints by resource. Construct the client, then call the typed methods you need.
 
+## Loading tables
+
+Loads are serialised per table on the server. `hotdata.DatabasesApi` and
+`hotdata.ConnectionsApi` retry a load that hits a table another load still
+holds (HTTP 409, error code `RESOURCE_LOCKED`), honouring the server's
+`Retry-After`, for up to 60s by default:
+
+```python
+from hotdata import DatabasesApi, LoadRetryPolicy, TableLockedError
+
+databases = DatabasesApi(api_client, load_retry=LoadRetryPolicy(deadline_s=120))
+try:
+    databases.load_database_table(db_id, "public", "events", request)
+except TableLockedError as e:
+    print(f"gave up after {e.attempts} attempts: {e.reason}")
+```
+
+Other 409s (`CONFLICT`, `IDEMPOTENCY_KEY_CONFLICT`) are raised immediately.
+
 ## Arrow results
 
 Query results can be fetched as an [Apache Arrow](https://arrow.apache.org/) IPC stream instead of JSON, which is faster and far more memory-efficient for large result sets. Install the optional extra:

{hotdata-0.10.0 → hotdata-0.12.0}/hotdata/__init__.py

@@ -5,7 +5,7 @@
 """
     Hotdata API
 
-    Powerful data platform API for managed databases, queries, and analytics.
+    Powerful data platform API for instant databases, queries, and analytics.
 
     The version of the OpenAPI document: 1.0.0
     Contact: developers@hotdata.dev
@@ -24,7 +24,6 @@ except PackageNotFoundError:  # running from a source checkout without install
 
 # Define package exports
 __all__ = [
-    "ConnectionTypesApi",
     "ConnectionsApi",
     "DatabaseContextApi",
     "DatabasesApi",
@@ -34,10 +33,8 @@ __all__ = [
     "JobsApi",
     "QueryApi",
     "QueryRunsApi",
-    "RefreshApi",
     "ResultsApi",
     "SavedQueriesApi",
-    "SecretsApi",
     "UploadsApi",
     "UsageApi",
     "WorkspacesApi",
@@ -74,12 +71,7 @@ __all__ = [
     "ColumnProfileDetailOneOf4",
     "ColumnProfileInfo",
     "ColumnTypeSpec",
-    "ConnectionHealthResponse",
     "ConnectionInfo",
-    "ConnectionRefreshResult",
-    "ConnectionSchemaError",
-    "ConnectionTypeDetail",
-    "ConnectionTypeSummary",
     "CreateConnectionRequest",
     "CreateConnectionResponse",
     "CreateDatabaseRequest",
@@ -88,8 +80,6 @@ __all__ = [
     "CreateEmbeddingProviderResponse",
     "CreateIndexRequest",
     "CreateSavedQueryRequest",
-    "CreateSecretRequest",
-    "CreateSecretResponse",
     "CreateUploadRequest",
     "CreateWorkspaceRequest",
     "CreateWorkspaceResponse",
@@ -100,6 +90,7 @@ __all__ = [
     "DatabaseDefaultSchemaDecl",
     "DatabaseDefaultTableDecl",
     "DatabaseDetailResponse",
+    "DatabaseLineageResponse",
     "DatabaseSummary",
     "DeleteDatabaseBatchResponse",
     "DiscoveryStatus",
@@ -110,10 +101,10 @@ __all__ = [
     "FinalizeUploadRequest",
     "FinalizeUploadResponse",
     "ForkDatabaseRequest",
+    "ForkedFromInfo",
     "GetConnectionResponse",
     "GetDatabaseContextResponse",
     "GetResultResponse",
-    "GetSecretResponse",
     "IndexEntryResponse",
     "IndexInfoResponse",
     "IndexStatus",
@@ -122,7 +113,8 @@ __all__ = [
     "JobStatus",
     "JobStatusResponse",
     "JobType",
-    "ListConnectionTypesResponse",
+    "LineageAncestorInfo",
+    "LineageForkInfo",
     "ListConnectionsResponse",
     "ListDatabaseContextsResponse",
     "ListDatabasesResponse",
@@ -134,11 +126,11 @@ __all__ = [
     "ListResultsResponse",
     "ListSavedQueriesResponse",
     "ListSavedQueryVersionsResponse",
-    "ListSecretsResponse",
     "ListWorkspacesResponse",
     "LoadManagedTableRequest",
     "LoadManagedTableResponse",
     "ManagedSchemaResponse",
+    "ManagedTableConstantPerKeyResponse",
     "ManagedTableResponse",
     "MintUploadPartsRequest",
     "MintUploadPartsResponse",
@@ -147,30 +139,22 @@ __all__ = [
     "QueryRequest",
     "QueryResponse",
     "QueryRunInfo",
-    "RefreshRequest",
-    "RefreshResponse",
-    "RefreshWarning",
     "ResultInfo",
     "ResultsFormatQuery",
     "SavedQueryDetail",
     "SavedQuerySummary",
     "SavedQueryVersionInfo",
-    "SchemaRefreshResult",
-    "SecretMetadataResponse",
     "SubmitJobResponse",
     "TableInfo",
     "TablePartitionKey",
     "TableProfileResponse",
-    "TableRefreshError",
-    "TableRefreshResult",
     "TableSortKey",
     "TemporalProfileDetail",
     "TextProfileDetail",
     "UpdateEmbeddingProviderRequest",
     "UpdateEmbeddingProviderResponse",
+    "UpdateManagedTableRequest",
     "UpdateSavedQueryRequest",
-    "UpdateSecretRequest",
-    "UpdateSecretResponse",
     "UploadSessionResponse",
     "UpsertDatabaseContextRequest",
     "UpsertDatabaseContextResponse",
@@ -180,7 +164,6 @@ __all__ = [
 ]
 
 # import apis into sdk package
-from hotdata.api.connection_types_api import ConnectionTypesApi as ConnectionTypesApi
 from hotdata.api.connections_api import ConnectionsApi as ConnectionsApi
 from hotdata.api.database_context_api import DatabaseContextApi as DatabaseContextApi
 from hotdata.api.databases_api import DatabasesApi as DatabasesApi
@@ -190,10 +173,8 @@ from hotdata.api.information_schema_api import InformationSchemaApi as Informati
 from hotdata.api.jobs_api import JobsApi as JobsApi
 from hotdata.api.query_api import QueryApi as QueryApi
 from hotdata.api.query_runs_api import QueryRunsApi as QueryRunsApi
-from hotdata.api.refresh_api import RefreshApi as RefreshApi
 from hotdata.api.results_api import ResultsApi as ResultsApi
 from hotdata.api.saved_queries_api import SavedQueriesApi as SavedQueriesApi
-from hotdata.api.secrets_api import SecretsApi as SecretsApi
 from hotdata.api.uploads_api import UploadsApi as UploadsApi
 from hotdata.api.usage_api import UsageApi as UsageApi
 from hotdata.api.workspaces_api import WorkspacesApi as WorkspacesApi
@@ -234,12 +215,7 @@ from hotdata.models.column_profile_detail_one_of3 import ColumnProfileDetailOneO
 from hotdata.models.column_profile_detail_one_of4 import ColumnProfileDetailOneOf4 as ColumnProfileDetailOneOf4
 from hotdata.models.column_profile_info import ColumnProfileInfo as ColumnProfileInfo
 from hotdata.models.column_type_spec import ColumnTypeSpec as ColumnTypeSpec
-from hotdata.models.connection_health_response import ConnectionHealthResponse as ConnectionHealthResponse
 from hotdata.models.connection_info import ConnectionInfo as ConnectionInfo
-from hotdata.models.connection_refresh_result import ConnectionRefreshResult as ConnectionRefreshResult
-from hotdata.models.connection_schema_error import ConnectionSchemaError as ConnectionSchemaError
-from hotdata.models.connection_type_detail import ConnectionTypeDetail as ConnectionTypeDetail
-from hotdata.models.connection_type_summary import ConnectionTypeSummary as ConnectionTypeSummary
 from hotdata.models.create_connection_request import CreateConnectionRequest as CreateConnectionRequest
 from hotdata.models.create_connection_response import CreateConnectionResponse as CreateConnectionResponse
 from hotdata.models.create_database_request import CreateDatabaseRequest as CreateDatabaseRequest
@@ -248,8 +224,6 @@ from hotdata.models.create_embedding_provider_request import CreateEmbeddingProv
 from hotdata.models.create_embedding_provider_response import CreateEmbeddingProviderResponse as CreateEmbeddingProviderResponse
 from hotdata.models.create_index_request import CreateIndexRequest as CreateIndexRequest
 from hotdata.models.create_saved_query_request import CreateSavedQueryRequest as CreateSavedQueryRequest
-from hotdata.models.create_secret_request import CreateSecretRequest as CreateSecretRequest
-from hotdata.models.create_secret_response import CreateSecretResponse as CreateSecretResponse
 from hotdata.models.create_upload_request import CreateUploadRequest as CreateUploadRequest
 from hotdata.models.create_workspace_request import CreateWorkspaceRequest as CreateWorkspaceRequest
 from hotdata.models.create_workspace_response import CreateWorkspaceResponse as CreateWorkspaceResponse
@@ -260,6 +234,7 @@ from hotdata.models.database_count_response import DatabaseCountResponse as Data
 from hotdata.models.database_default_schema_decl import DatabaseDefaultSchemaDecl as DatabaseDefaultSchemaDecl
 from hotdata.models.database_default_table_decl import DatabaseDefaultTableDecl as DatabaseDefaultTableDecl
 from hotdata.models.database_detail_response import DatabaseDetailResponse as DatabaseDetailResponse
+from hotdata.models.database_lineage_response import DatabaseLineageResponse as DatabaseLineageResponse
 from hotdata.models.database_summary import DatabaseSummary as DatabaseSummary
 from hotdata.models.delete_database_batch_response import DeleteDatabaseBatchResponse as DeleteDatabaseBatchResponse
 from hotdata.models.discovery_status import DiscoveryStatus as DiscoveryStatus
@@ -270,10 +245,10 @@ from hotdata.models.finalize_upload_part import FinalizeUploadPart as FinalizeUp
 from hotdata.models.finalize_upload_request import FinalizeUploadRequest as FinalizeUploadRequest
 from hotdata.models.finalize_upload_response import FinalizeUploadResponse as FinalizeUploadResponse
 from hotdata.models.fork_database_request import ForkDatabaseRequest as ForkDatabaseRequest
+from hotdata.models.forked_from_info import ForkedFromInfo as ForkedFromInfo
 from hotdata.models.get_connection_response import GetConnectionResponse as GetConnectionResponse
 from hotdata.models.get_database_context_response import GetDatabaseContextResponse as GetDatabaseContextResponse
 from hotdata.models.get_result_response import GetResultResponse as GetResultResponse
-from hotdata.models.get_secret_response import GetSecretResponse as GetSecretResponse
 from hotdata.models.index_entry_response import IndexEntryResponse as IndexEntryResponse
 from hotdata.models.index_info_response import IndexInfoResponse as IndexInfoResponse
 from hotdata.models.index_status import IndexStatus as IndexStatus
@@ -282,7 +257,8 @@ from hotdata.models.job_result import JobResult as JobResult
 from hotdata.models.job_status import JobStatus as JobStatus
 from hotdata.models.job_status_response import JobStatusResponse as JobStatusResponse
 from hotdata.models.job_type import JobType as JobType
-from hotdata.models.list_connection_types_response import ListConnectionTypesResponse as ListConnectionTypesResponse
+from hotdata.models.lineage_ancestor_info import LineageAncestorInfo as LineageAncestorInfo
+from hotdata.models.lineage_fork_info import LineageForkInfo as LineageForkInfo
 from hotdata.models.list_connections_response import ListConnectionsResponse as ListConnectionsResponse
 from hotdata.models.list_database_contexts_response import ListDatabaseContextsResponse as ListDatabaseContextsResponse
 from hotdata.models.list_databases_response import ListDatabasesResponse as ListDatabasesResponse
@@ -294,11 +270,11 @@ from hotdata.models.list_query_runs_response import ListQueryRunsResponse as Lis
 from hotdata.models.list_results_response import ListResultsResponse as ListResultsResponse
 from hotdata.models.list_saved_queries_response import ListSavedQueriesResponse as ListSavedQueriesResponse
 from hotdata.models.list_saved_query_versions_response import ListSavedQueryVersionsResponse as ListSavedQueryVersionsResponse
-from hotdata.models.list_secrets_response import ListSecretsResponse as ListSecretsResponse
 from hotdata.models.list_workspaces_response import ListWorkspacesResponse as ListWorkspacesResponse
 from hotdata.models.load_managed_table_request import LoadManagedTableRequest as LoadManagedTableRequest
 from hotdata.models.load_managed_table_response import LoadManagedTableResponse as LoadManagedTableResponse
 from hotdata.models.managed_schema_response import ManagedSchemaResponse as ManagedSchemaResponse
+from hotdata.models.managed_table_constant_per_key_response import ManagedTableConstantPerKeyResponse as ManagedTableConstantPerKeyResponse
 from hotdata.models.managed_table_response import ManagedTableResponse as ManagedTableResponse
 from hotdata.models.mint_upload_parts_request import MintUploadPartsRequest as MintUploadPartsRequest
 from hotdata.models.mint_upload_parts_response import MintUploadPartsResponse as MintUploadPartsResponse
@@ -307,30 +283,22 @@ from hotdata.models.numeric_profile_detail import NumericProfileDetail as Numeri
 from hotdata.models.query_request import QueryRequest as QueryRequest
 from hotdata.models.query_response import QueryResponse as QueryResponse
 from hotdata.models.query_run_info import QueryRunInfo as QueryRunInfo
-from hotdata.models.refresh_request import RefreshRequest as RefreshRequest
-from hotdata.models.refresh_response import RefreshResponse as RefreshResponse
-from hotdata.models.refresh_warning import RefreshWarning as RefreshWarning
 from hotdata.models.result_info import ResultInfo as ResultInfo
 from hotdata.models.results_format_query import ResultsFormatQuery as ResultsFormatQuery
 from hotdata.models.saved_query_detail import SavedQueryDetail as SavedQueryDetail
 from hotdata.models.saved_query_summary import SavedQuerySummary as SavedQuerySummary
 from hotdata.models.saved_query_version_info import SavedQueryVersionInfo as SavedQueryVersionInfo
-from hotdata.models.schema_refresh_result import SchemaRefreshResult as SchemaRefreshResult
-from hotdata.models.secret_metadata_response import SecretMetadataResponse as SecretMetadataResponse
 from hotdata.models.submit_job_response import SubmitJobResponse as SubmitJobResponse
 from hotdata.models.table_info import TableInfo as TableInfo
 from hotdata.models.table_partition_key import TablePartitionKey as TablePartitionKey
 from hotdata.models.table_profile_response import TableProfileResponse as TableProfileResponse
-from hotdata.models.table_refresh_error import TableRefreshError as TableRefreshError
-from hotdata.models.table_refresh_result import TableRefreshResult as TableRefreshResult
 from hotdata.models.table_sort_key import TableSortKey as TableSortKey
 from hotdata.models.temporal_profile_detail import TemporalProfileDetail as TemporalProfileDetail
 from hotdata.models.text_profile_detail import TextProfileDetail as TextProfileDetail
 from hotdata.models.update_embedding_provider_request import UpdateEmbeddingProviderRequest as UpdateEmbeddingProviderRequest
 from hotdata.models.update_embedding_provider_response import UpdateEmbeddingProviderResponse as UpdateEmbeddingProviderResponse
+from hotdata.models.update_managed_table_request import UpdateManagedTableRequest as UpdateManagedTableRequest
 from hotdata.models.update_saved_query_request import UpdateSavedQueryRequest as UpdateSavedQueryRequest
-from hotdata.models.update_secret_request import UpdateSecretRequest as UpdateSecretRequest
-from hotdata.models.update_secret_response import UpdateSecretResponse as UpdateSecretResponse
 from hotdata.models.upload_session_response import UploadSessionResponse as UploadSessionResponse
 from hotdata.models.upsert_database_context_request import UpsertDatabaseContextRequest as UpsertDatabaseContextRequest
 from hotdata.models.upsert_database_context_response import UpsertDatabaseContextResponse as UpsertDatabaseContextResponse
@@ -344,10 +312,21 @@ from hotdata.models.workspace_usage_response import WorkspaceUsageResponse as Wo
 # hotdata.query.QueryApi adds 429 retry + truncation auto-follow;
 # hotdata.arrow.ResultsApi adds Arrow IPC result fetch;
 # hotdata.uploads.UploadsApi adds transparent presigned direct-to-storage
-# uploads. The raw generated classes remain importable from hotdata.api.*.
+# uploads; hotdata.loads.DatabasesApi / ConnectionsApi retry table loads
+# while another load holds the table (409 RESOURCE_LOCKED). The raw
+# generated classes remain importable from hotdata.api.*.
 from hotdata.query import QueryApi as QueryApi  # noqa: E402,F811
 from hotdata.arrow import ResultsApi as ResultsApi  # noqa: E402,F811
 from hotdata.uploads import UploadsApi as UploadsApi  # noqa: E402,F811
+from hotdata.loads import DatabasesApi as DatabasesApi  # noqa: E402,F811
+from hotdata.loads import ConnectionsApi as ConnectionsApi  # noqa: E402,F811
+from hotdata.loads import (  # noqa: E402,F401
+    LoadRetryPolicy as LoadRetryPolicy,
+    TableLockedError as TableLockedError,
+)
+# Raised client-side (scripts/patch_workspace_guard.py) when a workspace-
+# scoped call has no workspace id configured.
+from hotdata._workspace import MissingWorkspaceError as MissingWorkspaceError  # noqa: E402,F401
 # The upload error hierarchy + option/helper types, so `from hotdata import
 # UploadError` / `StorageError` / ... works (they otherwise live only under
 # hotdata.uploads and are invisible to autocomplete on `hotdata.`).
@@ -382,4 +361,7 @@ __all__ += [  # noqa: F405
     "UploadProgress",
     "UploadSource",
     "tqdm_progress",
+    "LoadRetryPolicy",
+    "TableLockedError",
+    "MissingWorkspaceError",
 ]

hotdata-0.12.0/hotdata/_useragent.py

@@ -0,0 +1,52 @@
+"""The SDK's default ``User-Agent``.
+
+The generator's default is ``OpenAPI-Generator/1.0.0/python``, which identifies
+neither the SDK nor its version — server-side telemetry cannot tell a hotdata
+client from any other generated client, let alone one release from another.
+
+openapi-generator *does* expose an ``httpUserAgent`` property for this, but it
+bakes a literal string in at **generation** time. Regeneration is driven by
+OpenAPI spec changes, not by releases, so a baked version string reports
+whatever the version happened to be at the last regen — it would go stale
+silently and misattribute traffic, which is worse than the generic default. The
+version is therefore resolved at import time from installed package metadata,
+the same source :mod:`hotdata.__init__` uses for ``__version__``.
+
+This lives outside the generated modules (see ``.openapi-generator-ignore``) so
+a regeneration cannot overwrite it; ``scripts/patch_request_defaults.py`` only
+has to re-point ``ApiClient`` at the constant.
+"""
+
+from __future__ import annotations
+
+import importlib.metadata
+import platform
+
+import urllib3
+
+
+def _default_user_agent() -> str:
+    """``hotdata-python/<version> (Python/<py>; urllib3/<urllib3>)``.
+
+    The runtime versions ride along because the transport stack is where
+    client-side failures usually originate: knowing which urllib3 a bug report
+    came from is the difference between reproducing a problem and guessing.
+    """
+    try:
+        sdk_version = importlib.metadata.version("hotdata")
+    except importlib.metadata.PackageNotFoundError:
+        # Running from a source checkout without an install.
+        sdk_version = "0.0.0+unknown"
+    return (
+        f"hotdata-python/{sdk_version} "
+        f"(Python/{platform.python_version()}; urllib3/{urllib3.__version__})"
+    )
+
+
+#: Sent as ``User-Agent`` on every request. ``ApiClient.user_agent`` still
+#: overrides it per client, which is the supported way for an application to
+#: identify itself.
+USER_AGENT = _default_user_agent()
+
+
+__all__ = ["USER_AGENT", "_default_user_agent"]

hotdata-0.12.0/hotdata/_workspace.py

@@ -0,0 +1,84 @@
+"""Fail fast when a workspace-scoped request has no workspace to go to.
+
+Most operations are scoped to a workspace through the ``X-Workspace-Id``
+header (the ``WorkspaceId`` security scheme). The generated client simply
+skips a scheme that has no configured value, so a ``Configuration`` built
+without ``workspace_id`` sends the request anyway and the server answers with
+a bare 404 that says nothing about what was missing.
+
+:func:`ensure_workspace` runs before the request is sent (wired into
+``ApiClient.update_params_for_auth`` by ``scripts/patch_workspace_guard.py``)
+and raises :class:`MissingWorkspaceError` naming the constructor argument and
+the environment variable. Operations whose security does not list
+``WorkspaceId`` (workspace management itself) are unaffected, as are calls
+that supply the header explicitly or override auth per request.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Iterable, Mapping, Optional
+
+from hotdata.exceptions import ApiValueError
+
+WORKSPACE_SCHEME = "WorkspaceId"
+WORKSPACE_HEADER = "X-Workspace-Id"
+
+
+class MissingWorkspaceError(ApiValueError):
+    """Raised before sending a workspace-scoped request when no workspace id
+    is configured.
+
+    Pass ``workspace_id=`` to :class:`hotdata.Configuration`, set the
+    ``HOTDATA_WORKSPACE`` environment variable, or send the ``X-Workspace-Id``
+    header explicitly for the call.
+    """
+
+    def __init__(self, resource_path: str, method: str) -> None:
+        self.resource_path = resource_path
+        self.method = method
+        super().__init__(
+            f"{method} {resource_path} is scoped to a workspace but no workspace id "
+            "is configured. Pass workspace_id=... to hotdata.Configuration(...), "
+            "set the HOTDATA_WORKSPACE environment variable, or send the "
+            f"{WORKSPACE_HEADER} header explicitly (_headers=...)."
+        )
+
+
+def ensure_workspace(
+    configuration: Any,
+    auth_settings: Optional[Iterable[str]],
+    headers: Optional[Mapping[str, Any]],
+    resource_path: str,
+    method: str,
+    request_auth: Optional[Mapping[str, Any]] = None,
+) -> None:
+    """Raise :class:`MissingWorkspaceError` if the operation needs a workspace
+    id and none would be sent.
+
+    :param configuration: The client's :class:`hotdata.Configuration`.
+    :param auth_settings: The operation's security scheme names.
+    :param headers: Header params already assembled for the request.
+    :param request_auth: A per-request auth override; when given the
+        configuration is bypassed entirely, so the check is skipped.
+    """
+    if request_auth:
+        return
+    if not auth_settings or WORKSPACE_SCHEME not in auth_settings:
+        return
+    if headers and any(
+        str(name).lower() == WORKSPACE_HEADER.lower() for name in headers
+    ):
+        return
+    settings = configuration.auth_settings()
+    scheme = settings.get(WORKSPACE_SCHEME) if settings else None
+    if scheme and scheme.get("value"):
+        return
+    raise MissingWorkspaceError(resource_path, method)
+
+
+__all__ = [
+    "WORKSPACE_HEADER",
+    "WORKSPACE_SCHEME",
+    "MissingWorkspaceError",
+    "ensure_workspace",
+]

{hotdata-0.10.0 → hotdata-0.12.0}/hotdata/api/__init__.py

@@ -1,7 +1,6 @@
 # flake8: noqa
 
 # import apis into api package
-from hotdata.api.connection_types_api import ConnectionTypesApi
 from hotdata.api.connections_api import ConnectionsApi
 from hotdata.api.database_context_api import DatabaseContextApi
 from hotdata.api.databases_api import DatabasesApi
@@ -11,10 +10,8 @@ from hotdata.api.information_schema_api import InformationSchemaApi
 from hotdata.api.jobs_api import JobsApi
 from hotdata.api.query_api import QueryApi
 from hotdata.api.query_runs_api import QueryRunsApi
-from hotdata.api.refresh_api import RefreshApi
 from hotdata.api.results_api import ResultsApi
 from hotdata.api.saved_queries_api import SavedQueriesApi
-from hotdata.api.secrets_api import SecretsApi
 from hotdata.api.uploads_api import UploadsApi
 from hotdata.api.usage_api import UsageApi
 from hotdata.api.workspaces_api import WorkspacesApi