databricks-test

0.0.4 verified Fri May 01 auth: no python maintenance

A Python library for unit testing and mocking in Databricks environments. Current version 0.0.4, released by Microsoft as a sample. Minimal releases; appears to be in early maintenance mode.

pip install databricks-test

Common errors

error ModuleNotFoundError: No module named 'databricks_test' ↓

cause Library not installed or Python environment does not have it.

fix

Run: pip install databricks-test

error AttributeError: module 'databricks_test' has no attribute 'mock_dbutils' ↓

cause Wrong import path or library version mismatch.

fix

Use: from databricks_test import mock_dbutils (ensure version 0.0.4)

error TypeError: mock_dbutils() got an unexpected keyword argument 'dbutils_type' ↓

cause API changed or incorrect parameter usage.

fix

Check the source code for valid parameters; default call: mock_dbutils()

Warnings

gotcha The library is very early (v0.0.4) and likely incomplete. Not all DBUtils methods are mocked. ↓

fix Check the source code for available mocks; submit issues for missing ones.

gotcha Mocking SparkSession may not cover all Databricks-specific features. Use for basic unit tests only. ↓

fix Consider using other frameworks (e.g., chispa, delta-spark) for more advanced testing.

deprecated Official Microsoft samples are not actively maintained; no new releases since initial version. ↓

fix Plan to migrate to a more supported testing library if needed.

Imports

mock_dbutils
```
from databricks_test import mock_dbutils
```
Primary mocking utility for Databricks DBUtils
MockDbutils
```
from databricks_test import MockDbutils
```
Class-based mock for DBUtils

create_mock_spark

from databricks_test import create_mock_spark

Factory for mock SparkSession

Quickstart

Basic test using mock_dbutils.

from databricks_test import mock_dbutils

dbutils = mock_dbutils(dbutils_type='default')
print(dbutils.fs.ls('/'))