semblance-databricks 0.1.2__tar.gz → 0.2.0__tar.gz

{semblance_databricks-0.1.2/src/semblance_databricks.egg-info → semblance_databricks-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semblance-databricks
-Version: 0.1.2
+Version: 0.2.0
 Summary: Unofficial local HTTP simulation of selected Databricks workspace REST operations
 Author: Semblance Contributors
 License-Expression: MIT
@@ -11,19 +11,24 @@ Keywords: databricks,mock,simulation,testing,fastapi
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: semblance<1.0,>=0.8.0
+Requires-Dist: semblance<1.0,>=0.10.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
+Provides-Extra: test
+Requires-Dist: fastapi>=0.133.0; extra == "test"
+Requires-Dist: starlette>=1.3.1; extra == "test"
+Requires-Dist: httpx2>=2.13; extra == "test"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: httpx>=0.25.0; extra == "dev"
+Requires-Dist: fastapi>=0.133.0; extra == "dev"
+Requires-Dist: starlette>=1.3.1; extra == "dev"
+Requires-Dist: httpx2>=2.13; extra == "dev"
 Requires-Dist: ruff>=0.16.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
@@ -39,14 +44,17 @@ This package is **not affiliated with, endorsed by, or equivalent to Databricks*
 
 Verified against public workspace REST documentation dated **2026-08-19**. See `compatibility.yaml` (also served at `/.well-known/semblance-databricks-compat.json`).
 
-Requires `semblance` 0.8.x or 0.9.x (`>=0.8.0,<1.0`).
+Requires Python 3.11+ and `semblance` 0.10.x (`>=0.10.0,<1.0`). Python 3.10 users can use Databricks 0.1.x with `semblance<0.10`.
 
 ## Install
 
 ```bash
-pip install semblance-databricks
+pip install "semblance-databricks[test]"
 ```
 
+The `[test]` extra installs the in-process HTTP client used in the quick start.
+For CLI-only use, `pip install semblance-databricks` is enough.
+
 From a clone of this repository:
 
 ```bash
@@ -107,7 +115,7 @@ YAML/JSON version 1. Extra fields are rejected. Fixtures are **data only**. Secr
 
 List endpoints use `page_size` or `limit` plus `page_token` / `next_page_token`. Tokens are opaque and checksummed. Tampering returns 400 `INVALID_PARAMETER_VALUE`.
 
-## Known unsupported (0.1.2)
+## Known unsupported (0.2.0)
 
 - Unity Catalog, Model Serving, DLT / Spark Declarative Pipelines
 - Jobs API 2.0 as primary (optional 2.1 aliases are representative)

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/README.md

@@ -6,14 +6,17 @@ This package is **not affiliated with, endorsed by, or equivalent to Databricks*
 
 Verified against public workspace REST documentation dated **2026-08-19**. See `compatibility.yaml` (also served at `/.well-known/semblance-databricks-compat.json`).
 
-Requires `semblance` 0.8.x or 0.9.x (`>=0.8.0,<1.0`).
+Requires Python 3.11+ and `semblance` 0.10.x (`>=0.10.0,<1.0`). Python 3.10 users can use Databricks 0.1.x with `semblance<0.10`.
 
 ## Install
 
 ```bash
-pip install semblance-databricks
+pip install "semblance-databricks[test]"
 ```
 
+The `[test]` extra installs the in-process HTTP client used in the quick start.
+For CLI-only use, `pip install semblance-databricks` is enough.
+
 From a clone of this repository:
 
 ```bash
@@ -74,7 +77,7 @@ YAML/JSON version 1. Extra fields are rejected. Fixtures are **data only**. Secr
 
 List endpoints use `page_size` or `limit` plus `page_token` / `next_page_token`. Tokens are opaque and checksummed. Tampering returns 400 `INVALID_PARAMETER_VALUE`.
 
-## Known unsupported (0.1.2)
+## Known unsupported (0.2.0)
 
 - Unity Catalog, Model Serving, DLT / Spark Declarative Pipelines
 - Jobs API 2.0 as primary (optional 2.1 aliases are representative)

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "semblance-databricks"
-version = "0.1.2"
+version = "0.2.0"
 description = "Unofficial local HTTP simulation of selected Databricks workspace REST operations"
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "MIT"
 license-files = ["LICENSE.md"]
 authors = [{name = "Semblance Contributors"}]
@@ -16,21 +16,27 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Topic :: Software Development :: Testing",
 ]
 dependencies = [
-    "semblance>=0.8.0,<1.0",
+    "semblance>=0.10.0,<1.0",
     "pydantic>=2.0.0",
     "pyyaml>=6.0",
 ]
 
 [project.optional-dependencies]
+test = [
+    "fastapi>=0.133.0",
+    "starlette>=1.3.1",
+    "httpx2>=2.13",
+]
 dev = [
     "pytest>=7.0.0",
-    "httpx>=0.25.0",
+    "fastapi>=0.133.0",
+    "starlette>=1.3.1",
+    "httpx2>=2.13",
     "ruff>=0.16.0",
     "mypy>=1.0.0",
     "types-PyYAML>=6.0.0",

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/src/semblance_databricks/app.py

@@ -7,7 +7,7 @@ from collections.abc import Callable
 from importlib.metadata import PackageNotFoundError
 from importlib.metadata import version as pkg_version
 from pathlib import Path
-from typing import Any
+from typing import Any, Self
 
 from fastapi import FastAPI
 
@@ -37,7 +37,7 @@ def _distribution_version() -> str:
     try:
         return pkg_version("semblance-databricks")
     except PackageNotFoundError:
-        return "0.1.2"
+        return "0.2.0"
 
 
 class DatabricksMock:
@@ -49,13 +49,16 @@ class DatabricksMock:
         self.page_token_codec = PageTokenCodec(token_secret(self.config.seed))
         self._rng = random.Random(self.config.seed)
 
-    def load_fixture(self, path: str | Path) -> DatabricksMock:
-        self.state.clear()
+    def load_fixture(self, path: str | Path) -> Self:
         doc = load_fixture_file(path)
-        apply_fixture(doc, self.state)
+        staged_state = DatabricksState(seed=self.config.seed)
+        staged_state.statement_callbacks.update(self.state.statement_callbacks)
+        staged_state.user = dict(self.state.user)
+        apply_fixture(doc, staged_state)
+        self.state = staged_state
         return self
 
-    def load_bundled_fixture(self, name: str = "acme") -> DatabricksMock:
+    def load_bundled_fixture(self, name: str = "acme") -> Self:
         """Load a fixture shipped with the package (currently ``acme``)."""
         loader = _BUNDLED_FIXTURES.get(name)
         if loader is None:

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/src/semblance_databricks/compatibility.yaml

@@ -1,4 +1,4 @@
-packageVersion: "0.1.2"
+packageVersion: "0.2.0"
 documentedAt: "2026-08-19"
 source: "https://docs.databricks.com/api/workspace/"
 operations:

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/src/semblance_databricks/http.py

@@ -16,7 +16,7 @@ async def json_object(request: Request) -> dict[str, Any]:
         return {}
     try:
         body = json.loads(raw)
-    except json.JSONDecodeError as exc:
+    except (json.JSONDecodeError, UnicodeDecodeError) as exc:
         raise DatabricksError(400, "INVALID_PARAMETER_VALUE", "Invalid JSON") from exc
     if not isinstance(body, dict):
         raise DatabricksError(400, "INVALID_PARAMETER_VALUE", "JSON object required")

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/src/semblance_databricks/services/dbfs/routes.py

@@ -3,6 +3,9 @@
 from __future__ import annotations
 
 import base64
+import os
+import secrets
+import stat
 from pathlib import Path
 from typing import Any
 
@@ -45,7 +48,45 @@ def _write_temp(root: str, dbfs_path: str, data: bytes) -> None:
     except ValueError as exc:
         raise DatabricksError(400, "INVALID_PARAMETER_VALUE", "Invalid path") from exc
     dest.parent.mkdir(parents=True, exist_ok=True)
-    dest.write_bytes(data)
+    temp_path: Path | None = None
+    temp_fd: int | None = None
+    try:
+        try:
+            dest_mode = stat.S_IMODE(dest.stat().st_mode)
+        except FileNotFoundError:
+            dest_mode = None
+
+        for _ in range(100):
+            candidate = dest.parent / f".dbfs-{secrets.token_hex(8)}.tmp"
+            try:
+                temp_fd = os.open(
+                    candidate, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600
+                )
+            except FileExistsError:
+                continue
+            temp_path = candidate
+            break
+        if temp_fd is None or temp_path is None:
+            raise FileExistsError("Unable to create a temporary DBFS file")
+
+        try:
+            temp_file = os.fdopen(temp_fd, "wb")
+        except Exception:
+            os.close(temp_fd)
+            temp_fd = None
+            raise
+        temp_fd = None
+        with temp_file:
+            temp_file.write(data)
+        if dest_mode is not None:
+            os.chmod(temp_path, dest_mode)
+        os.replace(temp_path, dest)
+        temp_path = None
+    finally:
+        if temp_fd is not None:
+            os.close(temp_fd)
+        if temp_path is not None:
+            temp_path.unlink(missing_ok=True)
 
 
 def create_dbfs_router() -> APIRouter:
@@ -126,9 +167,9 @@ def create_dbfs_router() -> APIRouter:
         )
         if total > mock.config.dbfs_max_bytes:
             raise DatabricksError(400, "MAX_BLOCK_SIZE_EXCEEDED", "DBFS size cap")
-        mock.state.dbfs[path] = DbfsNode(path=path, is_dir=False, data=content)
         if mock.config.dbfs_temp_dir:
             _write_temp(mock.config.dbfs_temp_dir, path, content)
+        mock.state.dbfs[path] = DbfsNode(path=path, is_dir=False, data=content)
         mock.state.bump()
         return {}
 

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0}/src/semblance_databricks/testing.py

@@ -4,14 +4,24 @@ from __future__ import annotations
 
 from collections.abc import Iterator
 from pathlib import Path
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from fastapi.testclient import TestClient
+from fastapi import FastAPI
 
 from semblance_databricks.app import DatabricksMock
 from semblance_databricks.config import DatabricksMockConfig
 from semblance_databricks.fixtures.loaders import bundled_acme_path
 
+if TYPE_CHECKING:
+    from fastapi.testclient import TestClient
+
+
+def _make_test_client(app: FastAPI) -> TestClient:
+    """Load the optional test client backend only when a helper is used."""
+    from fastapi.testclient import TestClient
+
+    return TestClient(app)
+
 
 class DatabricksMockContext:
     """Load a fixture, yield a TestClient, reset state on exit."""
@@ -31,7 +41,7 @@ class DatabricksMockContext:
         self._client: TestClient | None = None
 
     def __enter__(self) -> TestClient:
-        self._client = TestClient(self.mock.as_fastapi())
+        self._client = _make_test_client(self.mock.as_fastapi())
         return self._client
 
     def __exit__(self, *exc: Any) -> None:
@@ -50,7 +60,7 @@ def databricks_test_client(
     if mock is None:
         mock = DatabricksMock(config or DatabricksMockConfig())
         mock.load_fixture(fixture if fixture is not None else bundled_acme_path())
-    return TestClient(mock.as_fastapi())
+    return _make_test_client(mock.as_fastapi())
 
 
 def acme_client_iter(
@@ -58,7 +68,7 @@ def acme_client_iter(
 ) -> Iterator[tuple[DatabricksMock, TestClient]]:
     mock = DatabricksMock(config or DatabricksMockConfig(seed=42))
     mock.load_fixture(bundled_acme_path())
-    client = TestClient(mock.as_fastapi())
+    client = _make_test_client(mock.as_fastapi())
     try:
         yield mock, client
     finally:

{semblance_databricks-0.1.2 → semblance_databricks-0.2.0/src/semblance_databricks.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semblance-databricks
-Version: 0.1.2
+Version: 0.2.0
 Summary: Unofficial local HTTP simulation of selected Databricks workspace REST operations
 Author: Semblance Contributors
 License-Expression: MIT
@@ -11,19 +11,24 @@ Keywords: databricks,mock,simulation,testing,fastapi
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
-Requires-Dist: semblance<1.0,>=0.8.0
+Requires-Dist: semblance<1.0,>=0.10.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
+Provides-Extra: test
+Requires-Dist: fastapi>=0.133.0; extra == "test"
+Requires-Dist: starlette>=1.3.1; extra == "test"
+Requires-Dist: httpx2>=2.13; extra == "test"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: httpx>=0.25.0; extra == "dev"
+Requires-Dist: fastapi>=0.133.0; extra == "dev"
+Requires-Dist: starlette>=1.3.1; extra == "dev"
+Requires-Dist: httpx2>=2.13; extra == "dev"
 Requires-Dist: ruff>=0.16.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
@@ -39,14 +44,17 @@ This package is **not affiliated with, endorsed by, or equivalent to Databricks*
 
 Verified against public workspace REST documentation dated **2026-08-19**. See `compatibility.yaml` (also served at `/.well-known/semblance-databricks-compat.json`).
 
-Requires `semblance` 0.8.x or 0.9.x (`>=0.8.0,<1.0`).
+Requires Python 3.11+ and `semblance` 0.10.x (`>=0.10.0,<1.0`). Python 3.10 users can use Databricks 0.1.x with `semblance<0.10`.
 
 ## Install
 
 ```bash
-pip install semblance-databricks
+pip install "semblance-databricks[test]"
 ```
 
+The `[test]` extra installs the in-process HTTP client used in the quick start.
+For CLI-only use, `pip install semblance-databricks` is enough.
+
 From a clone of this repository:
 
 ```bash
@@ -107,7 +115,7 @@ YAML/JSON version 1. Extra fields are rejected. Fixtures are **data only**. Secr
 
 List endpoints use `page_size` or `limit` plus `page_token` / `next_page_token`. Tokens are opaque and checksummed. Tampering returns 400 `INVALID_PARAMETER_VALUE`.
 
-## Known unsupported (0.1.2)
+## Known unsupported (0.2.0)
 
 - Unity Catalog, Model Serving, DLT / Spark Declarative Pipelines
 - Jobs API 2.0 as primary (optional 2.1 aliases are representative)

semblance_databricks-0.2.0/src/semblance_databricks.egg-info/requires.txt

@@ -0,0 +1,20 @@
+semblance<1.0,>=0.10.0
+pydantic>=2.0.0
+pyyaml>=6.0
+
+[dev]
+pytest>=7.0.0
+fastapi>=0.133.0
+starlette>=1.3.1
+httpx2>=2.13
+ruff>=0.16.0
+mypy>=1.0.0
+types-PyYAML>=6.0.0
+
+[sdk]
+databricks-sdk==0.57.0
+
+[test]
+fastapi>=0.133.0
+starlette>=1.3.1
+httpx2>=2.13

semblance_databricks-0.1.2/src/semblance_databricks.egg-info/requires.txt

@@ -1,13 +0,0 @@
-semblance<1.0,>=0.8.0
-pydantic>=2.0.0
-pyyaml>=6.0
-
-[dev]
-pytest>=7.0.0
-httpx>=0.25.0
-ruff>=0.16.0
-mypy>=1.0.0
-types-PyYAML>=6.0.0
-
-[sdk]
-databricks-sdk==0.57.0