semblance-databricks 0.1.0__py3-none-any.whl

semblance_databricks-0.1.0.dist-info/METADATA

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: semblance-databricks
+Version: 0.1.0
+Summary: Unofficial local HTTP simulation of selected Databricks workspace REST operations
+Author: Semblance Contributors
+License-Expression: MIT
+Project-URL: Documentation, https://semblance.readthedocs.io/en/latest/guides/databricks/
+Project-URL: Repository, https://github.com/eddiethedean/semblance
+Project-URL: Changelog, https://github.com/eddiethedean/semblance/blob/main/packages/semblance-databricks/CHANGELOG.md
+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
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: semblance<0.8,>=0.7.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: httpx>=0.25.0; 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"
+Provides-Extra: sdk
+Requires-Dist: databricks-sdk==0.57.0; extra == "sdk"
+Dynamic: license-file
+
+# semblance-databricks
+
+**Unofficial** local HTTP simulation of selected [Databricks workspace REST](https://docs.databricks.com/api/workspace/) operations (clusters, jobs, warehouses, secrets metadata, DBFS stubs, permissions, SQL statements).
+
+This package is **not affiliated with, endorsed by, or equivalent to Databricks**. It does not run Spark, jobs, or SQL engines. It is a test double for client development and CI.
+
+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.7.x.
+
+## Install
+
+```bash
+pip install semblance-databricks
+```
+
+From a clone of this repository:
+
+```bash
+pip install -e ".[dev]"
+pip install -e "packages/semblance-databricks[dev]"
+```
+
+Optional official SDK extra (not installed in default CI):
+
+```bash
+pip install "semblance-databricks[sdk]"
+pytest packages/semblance-databricks/tests -m sdk
+```
+
+Pinned SDK: `databricks-sdk==0.57.0`. Untested SDK versions are not implied compatible.
+
+## Quick start (HTTP)
+
+```python
+from semblance_databricks import DatabricksMock, DatabricksMockConfig
+from semblance_databricks.testing import databricks_test_client
+
+dbx = DatabricksMock(DatabricksMockConfig(seed=42, auth="optional"))
+dbx.load_bundled_fixture()
+client = databricks_test_client(dbx)
+
+r = client.get("/api/2.1/clusters/list?page_size=2")
+assert r.status_code == 200
+```
+
+CLI:
+
+```bash
+semblance-databricks fixture init --output databricks.yaml
+semblance-databricks validate databricks.yaml
+semblance-databricks operations
+semblance-databricks serve --fixture databricks.yaml --port 8766
+# or: semblance-databricks serve   # bundled acme fixture
+```
+
+Environment variables for local clients (not Databricks credentials): `SEMBLANCE_DATABRICKS_HOST`, `SEMBLANCE_DATABRICKS_TOKEN`.
+
+## Auth modes
+
+- `disabled` — ignore `Authorization`
+- `optional` (default) — missing token is OK; malformed `Bearer` values return 401
+- `strict` — token must be in `DatabricksMockConfig.tokens`
+
+Authentication errors never echo the token. This is not an OAuth server.
+
+## Fixtures
+
+YAML/JSON version 1. Extra fields are rejected. Fixtures are **data only**. Secret **values** are never returned on REST (list and put only; there is no get-key).
+
+`load_bundled_fixture()` loads the shipped `acme` workspace. Use `load_fixture(path)` for your own files. Advance cluster/run state with `dbx.tick()`.
+
+## Pagination
+
+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.0)
+
+- Unity Catalog, Model Serving, DLT / Spark Declarative Pipelines
+- Jobs API 2.0 as primary (optional 2.1 aliases are representative)
+- Real Spark/SQL execution (statements use fixture or allow-listed callbacks)
+
+Unknown paths return Databricks-style 404. Known stubs such as `clusters/permanent-delete` and `dbfs/add-block` return 501 only when `auth=strict`.
+
+## Security
+
+- Do not put production secrets in fixtures or tokens used with this mock
+- Tokens are compared in-process and never written to error bodies
+- Query/SQL/run-output behavior must be allow-listed Python, never YAML eval
+
+## License
+
+MIT. Databricks is a trademark of its respective owners.

semblance_databricks-0.1.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+semblance_databricks/__init__.py,sha256=YRrm2_pCljJfLlwazJTSdQKqv3tFnvqYoS24z4AkQHM,604
+semblance_databricks/app.py,sha256=PsGD-zpoJxRxOOOV8wTqHP_DDae2A53w70EtvxuPN-w,4004
+semblance_databricks/auth.py,sha256=X__Xcb4HycYnkJI_nSHGhla7g_t2cjL4BSRWOUjkJFQ,4984
+semblance_databricks/cli.py,sha256=u1OGkE7ebAjdP6QrFzmyREW0NMDQFI6g8fIgoOae0r8,3746
+semblance_databricks/compatibility.py,sha256=60WcHZA7lRmwTGwyVPUpq5HPKncOamfKTeZjHQuSvy0,789
+semblance_databricks/compatibility.yaml,sha256=cSbC-TyTgnOWpCE-1uFA5937Fvrh9RHOvYhacw-ABYI,9624
+semblance_databricks/config.py,sha256=JoNaBS5Z_zXQpqXvOJazPjEMf26lRwEM5XO9kBuMeLc,1644
+semblance_databricks/errors.py,sha256=n2ar51SahIAeps8Fb_ndjuHmdVnLZB-OGf8t4M6ZGB0,2405
+semblance_databricks/http.py,sha256=buPaC68pSXfSfQFXzavuB7q-3tKB4MehLz3XgRE_P1g,956
+semblance_databricks/ids.py,sha256=k2uY1X0EY3w9noDg9DJWBI-h8buV1F0N_fP6UEZS36M,2869
+semblance_databricks/pagination.py,sha256=Gb61Jo-DmLgnBPZSTJAp3e5RP7VsSOOKORfLtfbK8dM,1338
+semblance_databricks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+semblance_databricks/registry.py,sha256=bGGjKn4HZbWjGcOGHKoRxxoNDXytWScZx5ojfGCm6hs,783
+semblance_databricks/state.py,sha256=uqKWP8kYP7UdWpDQfNoTQm6nuRsNgyKNq1OQPuPn7tg,8296
+semblance_databricks/testing.py,sha256=SR5OteJ065UBRfYCYU6O-EA24FkUiFYMnEV_2MzOWBE,2100
+semblance_databricks/fixtures/__init__.py,sha256=2Lrgm7cKpkqVil-prJqBwursSD1P-3kvdDTz6fYNRHI,165
+semblance_databricks/fixtures/loaders.py,sha256=Lp-rVRFovgcUiUt2slTdsj5iSp9s73Kct27Ku-rqILc,6105
+semblance_databricks/fixtures/defaults/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+semblance_databricks/fixtures/defaults/acme.yaml,sha256=Pwy4hpGICRgRQpMgWGTKZxBHJGNuoD1I7vnh4pvUXeo,1003
+semblance_databricks/models/__init__.py,sha256=-G3mJBUgjAoaDXKsmHU_o7zBHPt3XREprbDNMnt2RNQ,21
+semblance_databricks/services/__init__.py,sha256=g5bgRNKr_gg_6fLxuy-ociPo630HOXL7U1vbUM-Ya3g,34
+semblance_databricks/services/deps.py,sha256=PQn6CO8y6UO4qYQS3WxiT0fXRGpZtg7ltvS5xljohqk,1148
+semblance_databricks/services/clusters/__init__.py,sha256=ZjpuN9wF24uILNYNt2ZsCSJVDEgBs6R1A6htaPJ0Co8,119
+semblance_databricks/services/clusters/routes.py,sha256=6ql8EUv8Ll3yGa5J1thGI9hILTvHQJxD16XzFhvBdns,7414
+semblance_databricks/services/dbfs/__init__.py,sha256=Afhji_fzuUkd1YXV4zb6OShVs1x2D8-r_zGw23gYm98,107
+semblance_databricks/services/dbfs/routes.py,sha256=XopRHH4tXwUVeFrJbwAWqJX5KWkLffws5iNG9D2kKqc,4546
+semblance_databricks/services/dbsql/__init__.py,sha256=kXwHdaRLCSvzzSmSXJcBHNdT3b8MoqKYtlu4MCGM264,110
+semblance_databricks/services/dbsql/routes.py,sha256=7smQQaJj419qv8sw57Y1mhlBegvZWbZU4FmQYGBCSyk,5964
+semblance_databricks/services/jobs/__init__.py,sha256=jX8CZKyoMSp9IXDdAd-NmeG__NTRrjI1ZFYwoS-IJf0,107
+semblance_databricks/services/jobs/routes.py,sha256=pZjgY4k4fhSgrUnCvc42_xszoSUTijywJLMNdChZUDI,6910
+semblance_databricks/services/permissions/__init__.py,sha256=8Ud8t7Js8abRotNDPGYFwXYdDYWDYvqBgsIiK-r7VSU,137
+semblance_databricks/services/permissions/routes.py,sha256=waM1B6da8C8JvXC2HsO0iKLX6_78-gSsavJ4rBriWF4,1579
+semblance_databricks/services/secrets/__init__.py,sha256=mCf-YRlphVw9jOB23p30-0s11IaMmIyDPyN0iP9xcX4,116
+semblance_databricks/services/secrets/routes.py,sha256=28CYn-LevWk6Xy5GRcMHTGoSB8LD9iVud_hdzXFxu2E,1892
+semblance_databricks/services/workspace/__init__.py,sha256=427FBIzmE29Jp1C8q5icALDkDRQ1WZQdUV4FKQNZpWs,122
+semblance_databricks/services/workspace/routes.py,sha256=1ffVHMpEgRNU1UCMGhxDMdvYzk_qF4Yb0hg7bHyCTFc,1161
+semblance_databricks-0.1.0.dist-info/licenses/LICENSE.md,sha256=FAk7E17XygPXI2ryakEqlgZkpLlwY25EMlV7VEIFJ_k,1079
+semblance_databricks-0.1.0.dist-info/METADATA,sha256=9vp2zCT7H9Lwa3bBM7sxM4wat2C-0t6Rhas5F6xcayk,4742
+semblance_databricks-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+semblance_databricks-0.1.0.dist-info/entry_points.txt,sha256=bDxtD3uxlrYhauGjOh_-EsAX4-Wd4FkFK6bqrT4zTbw,71
+semblance_databricks-0.1.0.dist-info/top_level.txt,sha256=gXTlFe5MHYCa7KqmYHk9kIeUWj1NNnu-ThQzma2z8AY,21
+semblance_databricks-0.1.0.dist-info/RECORD,,

semblance_databricks-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

semblance_databricks-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+semblance-databricks = semblance_databricks.cli:main

semblance_databricks-0.1.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Semblance Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

semblance_databricks-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+semblance_databricks