semblance-databricks
Unofficial local HTTP simulation of selected Databricks workspace REST 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 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
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:
pip install -e ".[dev]"
pip install -e "packages/semblance-databricks[dev]"
Optional official SDK extra (not installed in default CI):
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)
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:
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— ignoreAuthorizationoptional(default) — missing token is OK; malformedBearervalues return 401strict— token must be inDatabricksMockConfig.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.2.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.
Metadata
Release files for semblance-databricks 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| semblance_databricks-0.2.0.tar.gz | 27.0 kB | With provenance | Details for semblance_databricks-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| semblance_databricks-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for semblance_databricks-0.2.0-py3-none-any.whl |
Total release size: 63.7 kB
Release files / semblance_databricks-0.2.0.tar.gz
| Download URL | semblance_databricks-0.2.0.tar.gz |
|---|---|
| Size | 27.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d64c0b1818c664cce960882c03a1e00546236a536b7e585cfd358b2930a504d1
|
|
BLAKE2b-256 checksum How to use checksums |
560b6e1c442ab95dab3c6ba5f1c65d50a89feb763848cf90cca83b5b8449795e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logRelease files / semblance_databricks-0.2.0-py3-none-any.whl
| Download URL | semblance_databricks-0.2.0-py3-none-any.whl |
|---|---|
| Size | 36.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c56217ab0137de209d09d3fa367f8d13215f58700616a4f08a36048bf3a7761
|
|
BLAKE2b-256 checksum How to use checksums |
f4f036c2cf8ff8693fb3eb7a52d5f335f3f38b556e13d9385c86a8c56089b9c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logSecurity for semblance-databricks 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for semblance_databricks-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.