{"id":23643,"library":"dummy-notebookutils","title":"Azure Synapse Analytics Notebook Utilities Stub","description":"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.","status":"active","version":"1.6.3","language":"python","source_language":"en","source_url":"https://github.com/Azure/azure-synapse-analytics","tags":["azure","synapse","notebook","stub","mock","mssparkutils"],"install":[{"cmd":"pip install dummy-notebookutils","lang":"bash","label":"Default install"},{"cmd":"pip install dummy-notebookutils==1.6.3","lang":"bash","label":"Pin version"}],"dependencies":[],"imports":[{"note":"Top-level mssparkutils package does not exist; use notebookutils module.","wrong":"from mssparkutils import mssparkutils","symbol":"mssparkutils","correct":"from notebookutils import mssparkutils"}],"quickstart":{"code":"from notebookutils import mssparkutils\n\n# Example: list files in a lakehouse path\npath = \"abfss://container@storage.dfs.core.windows.net/\"\nfiles = mssparkutils.fs.ls(path)\nprint(files)\n\n# Example: get secret (dummy returns placeholder)\nsecret = mssparkutils.credentials.getSecret(\"my-key-vault\", \"my-secret\")\nprint(secret)","lang":"python","description":"Basic usage to verify import and understand the dummy API."},"warnings":[{"fix":"Wrap usage in a try-except or environment check to use real mssparkutils on Synapse and dummy locally.","message":"All functions return dummy/placeholder values, not real data. The package is intended only for local development and CI; never use in production.","severity":"gotcha","affected_versions":"all"},{"fix":"Check the stub's source code on GitHub to verify method existence before relying on it.","message":"The package may not cover all mssparkutils APIs. Methods like `mssparkutils.env` or newer additions may be missing.","severity":"breaking","affected_versions":"<1.6.3"},{"fix":"Consider alternatives like `mssparkutils` stubs from other sources or mock the API yourself.","message":"The package is no longer actively maintained; no updates since 2023.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install dummy-notebookutils` and ensure the Python environment is the same as the execution context.","cause":"Package not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'notebookutils'"},{"fix":"Use `from notebookutils import mssparkutils` (the stub's top-level module is notebookutils).","cause":"Import path mistake; common wrong import: `from mssparkutils import mssparkutils`.","error":"AttributeError: module 'notebookutils' has no attribute 'mssparkutils'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}