feat: initial sdk-python scaffold

Author: zfarrell

.github/workflows/regenerate.yml

@@ -0,0 +1,33 @@
+name: Regenerate Client
+
+on:
+  repository_dispatch:
+    types: [openapi-updated]
+  workflow_dispatch:
+
+jobs:
+  regenerate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Fetch merged OpenAPI spec
+        run: |
+          curl -sL https://raw.githubusercontent.com/hotdata-dev/www.hotdata.dev/main/api/openapi.yaml \
+            -o openapi.yaml
+
+      - name: Generate client
+        run: |
+          npx @openapitools/openapi-generator-cli generate \
+            -i openapi.yaml \
+            -g python \
+            -o generated/ \
+            --additional-properties=packageName=hotdata,projectName=hotdata
+
+      - name: Create PR
+        uses: peter-evans/create-pull-request@v6
+        with:
+          title: "chore: regenerate client from updated OpenAPI spec"
+          branch: openapi-update
+          commit-message: "chore: regenerate client from OpenAPI spec"
+          body: "Auto-generated from updated HotData OpenAPI spec."

.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.pyc

pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "hotdata"
+version = "0.1.0"
+description = "Python client for the HotData API"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hotdata"]

src/hotdata/__init__.py

@@ -0,0 +1,3 @@
+from .client import HotdataClient
+
+__all__ = ["HotdataClient"]

src/hotdata/client.py

@@ -0,0 +1,37 @@
+# This client is a minimal scaffold. It will be replaced by auto-generated
+# code from the HotData OpenAPI spec via the regenerate workflow.
+
+from __future__ import annotations
+
+import httpx
+
+
+class HotdataClient:
+    """Minimal HotData API client."""
+
+    def __init__(
+        self,
+        api_token: str,
+        workspace_id: str,
+        base_url: str = "https://api.hotdata.dev",
+    ) -> None:
+        self.base_url = base_url
+        self._client = httpx.Client(
+            base_url=base_url,
+            headers={
+                "Authorization": f"Bearer {api_token}",
+                "X-Workspace-Id": workspace_id,
+            },
+        )
+
+    def health(self) -> httpx.Response:
+        return self._client.get("/health")
+
+    def __enter__(self) -> HotdataClient:
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self._client.close()
+
+    def close(self) -> None:
+        self._client.close()