Registry / azure / dummy-notebookutils

dummy-notebookutils

library1.6.3pypypi✓ verified 84d ago

A stub package that mimics the `mssparkutils` API from Azure Synapse Analytics notebooks, allowing local development and CI builds without a Synapse environment. Current version is 1.6.3. Released on PyPI with low cadence; no official changelog.

azure type-stubs

pip install dummy-notebookutils

github ↗package ↗

INSTALL

IMPORT

SIG · DUMMY-NOTEBOOKUTIL

dummy-notebookutils

azurepythonv1.6.3

Install

1.5s avg

Import

42ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.6.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.043s · 18MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 1.5s · import 0.040s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

mssparkutils

✓ from notebookutils import mssparkutils

✗ from mssparkutils import mssparkutils

Top-level mssparkutils package does not exist; use notebookutils module.

Basic usage to verify import and understand the dummy API.

from notebookutils import mssparkutils # Example: list files in a lakehouse path path = "abfss://container@storage.dfs.core.windows.net/" files = mssparkutils.fs.ls(path) print(files) # Example: get secret (dummy returns placeholder) secret = mssparkutils.credentials.getSecret("my-key-vault", "my-secret") print(secret)

Debug

Known issues

gotchaAll functions return dummy/placeholder values, not real data. The package is intended only for local development and CI; never use in production.

fix

Wrap usage in a try-except or environment check to use real mssparkutils on Synapse and dummy locally.

affects: all

breakingThe package may not cover all mssparkutils APIs. Methods like `mssparkutils.env` or newer additions may be missing.

fix

Check the stub's source code on GitHub to verify method existence before relying on it.

affects: <1.6.3

deprecatedThe package is no longer actively maintained; no updates since 2023.

fix

Consider alternatives like `mssparkutils` stubs from other sources or mock the API yourself.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'notebookutils'

Package not installed or installed in a different environment.

fix

Run `pip install dummy-notebookutils` and ensure the Python environment is the same as the execution context.

AttributeError: module 'notebookutils' has no attribute 'mssparkutils'

Import path mistake; common wrong import: `from mssparkutils import mssparkutils`.

fix

Use `from notebookutils import mssparkutils` (the stub's top-level module is notebookutils).

Upgrade

Version history

1.6.3latest on PyPI · released Jan 22, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

45 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Azure/azure-synapse-analytics ↗

packagehttps://pypi.org/project/dummy-notebookutils/ ↗