semantic-link-labs 0.9.11__py3-none-any.whl → 0.10.0__py3-none-any.whl

{semantic_link_labs-0.9.11.dist-info → semantic_link_labs-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: semantic-link-labs
-Version: 0.9.11
+Version: 0.10.0
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -27,7 +27,7 @@ Dynamic: license-file
 # Semantic Link Labs
 
 [![PyPI version](https://badge.fury.io/py/semantic-link-labs.svg)](https://badge.fury.io/py/semantic-link-labs)
-[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.11&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.10.0&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 [![Downloads](https://static.pepy.tech/badge/semantic-link-labs)](https://pepy.tech/project/semantic-link-labs)
 
@@ -154,6 +154,7 @@ An even better way to ensure the semantic-link-labs library is available in your
 2. Select your newly created environment within the 'Environment' drop down in the navigation bar at the top of the notebook
 
 ## Version History
+* [0.10.0](https://github.com/microsoft/semantic-link-labs/releases/tag/0.10.0) (May 30, 2025)
 * [0.9.11](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.11) (May 22, 2025)
 * [0.9.10](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.10) (April 24, 2025)
 * [0.9.9](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.9) (April 7, 2025)

{semantic_link_labs-0.9.11.dist-info → semantic_link_labs-0.10.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-semantic_link_labs-0.9.11.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
-sempy_labs/__init__.py,sha256=X39q1v8jygmKdGc0kfuRcn7V1MAHxzG5mDivJxON7Go,16255
+semantic_link_labs-0.10.0.dist-info/licenses/LICENSE,sha256=ws_MuBL-SCEBqPBFl9_FqZkaaydIJmxHrJG2parhU4M,1141
+sempy_labs/__init__.py,sha256=RzY_bcDROFRZHTNuEUXpmYOUDZzTSZT7DpT4k_cJbHw,16363
 sempy_labs/_ai.py,sha256=BD1TdGOJ7T4m3x426OP-FLb7bevn-9gKY8BTEDAJDQU,16205
 sempy_labs/_authentication.py,sha256=GjtN5XqIyWXbR5Ni4hfYiUNwgFa-ySX8e-BrqE1vgGc,6903
 sempy_labs/_capacities.py,sha256=n48NYTY03zygRzcfyK1UOkSwTqKSyQefQ10IKQh-dfA,40426
@@ -14,6 +14,7 @@ sempy_labs/_dax_query_view.py,sha256=_zSvgystZzBj5euNTLKTg7-G77XVk0vqyqrDT72VvoM
 sempy_labs/_delta_analyzer.py,sha256=d6qxZrEhn3Hfg5qMQODt7dDG5mYSY18xeXUkW_NyMgw,17281
 sempy_labs/_delta_analyzer_history.py,sha256=A50dlBd2d3ILKV7Fwj4pfIRtXKmCFslhk1gpeEw4inc,10765
 sempy_labs/_deployment_pipelines.py,sha256=SDQYkCAhOAlxBr58jYxtLFOVySiRXO0_WhfOKGDeYZQ,6254
+sempy_labs/_dictionary_diffs.py,sha256=DCXuASmt45gshsBO1FgSZDqxm68DnojuDcO-H35EH7Q,9003
 sempy_labs/_documentation.py,sha256=yVA8VPEzx_fmljtcvSxtB7-BeupYsfdMXXjp6Fpnyo8,5007
 sempy_labs/_environments.py,sha256=c_9uU6zhVmZVTLZWuD-OdcicBJvmRQQVmqHW7EqUn_Q,5839
 sempy_labs/_eventhouses.py,sha256=WEf33difBOTGTZGh1QFmY4gv-e43uwO1V54nrsjGGyY,5376
@@ -23,7 +24,7 @@ sempy_labs/_gateways.py,sha256=6JE6VeGFPKF617sf2mMkxXVOz57YHI5jAQLAF-BzRLc,17527
 sempy_labs/_generate_semantic_model.py,sha256=F2NVW6kT1HnrZTqWnDZ4BRApbsUfLFDSsDbRzCJnc0o,18429
 sempy_labs/_git.py,sha256=RyaT4XzrSi-4NLJZWiWZnnNpMgrKzRNxhyY8b1O2I6c,17819
 sempy_labs/_graphQL.py,sha256=truXeIUPRKLwc4skhs3FZYNcKP9FCGKly9en0YkR4NE,2690
-sempy_labs/_helper_functions.py,sha256=SbFhIT_6j8xSkFflzuWWoo_NIH_uqPuINUGvcblPy7s,68762
+sempy_labs/_helper_functions.py,sha256=9HhCH3xdEMjS50K7UBAjwnLiQPS4whVZco3v__k8bQU,74249
 sempy_labs/_icons.py,sha256=SB9EQeoFCfD4bO6fcYuJOoPRSYenSrW0rI9G5RFsH28,3579
 sempy_labs/_job_scheduler.py,sha256=_-Pifkttk1oPNxewxwWcQ4QC_Hr24GSi6nmrEXwc0pc,15814
 sempy_labs/_kql_databases.py,sha256=UtpYVBsxwWQDnqwdjq186bZzw5IlkD2S9KHA6Kw75U0,4738
@@ -47,14 +48,15 @@ sempy_labs/_query_scale_out.py,sha256=nra1q8s-PKpZTlI_L0lMGO1GmdBk6sqETsBQShF1yP
 sempy_labs/_refresh_semantic_model.py,sha256=4w_uaYLbaZptmEFY7QHWzOgXcgc2ctGx8HQvt2aguxk,17360
 sempy_labs/_semantic_models.py,sha256=F9v964IiXqx2qNPtNBzYrWPtXIoQH5-FI5csWJGofoQ,7934
 sempy_labs/_spark.py,sha256=SuSTjjmtzj7suDgN8Njk_pNBaStDLgIJB_1yk_e2H1Y,19340
-sempy_labs/_sql.py,sha256=6mtX0I2VTpmpMbAiqdQGPyLiLN3q3pVDTP9IW7Z3JfA,8276
+sempy_labs/_sql.py,sha256=BnL7Syd9vJZFysSiILYhqwTFS4y30nvkhDLQXGjtveE,8281
 sempy_labs/_sqldatabase.py,sha256=8HV3UtsLiwexmPSjYnhnYnD6xEvgFpTG13jcOuGheuI,6470
 sempy_labs/_tags.py,sha256=7DvSc3wah26DxHwUhr-yr_JhZiplrePkFaDaVIAQfV4,5666
 sempy_labs/_translations.py,sha256=i4K2PFk6-TcmAnUpqz-z_GuDv9XEp1cBs0KY-x6ja1w,16168
+sempy_labs/_user_delegation_key.py,sha256=5Qre0ZB_atajtwWfFQqD12q413Fz313GK9nrA9IIwjI,1414
 sempy_labs/_utils.py,sha256=aKGnUiXSLLRQRXXv8TH_XhGcOtDsnrs0RHmQ6YZMn3o,1786
 sempy_labs/_variable_libraries.py,sha256=t97gj8Mo-YjahKx6XObqh5HkhUMHUke5GdWpSzkC5ZM,3008
 sempy_labs/_vertipaq.py,sha256=1UvB79xOxeGdRFINsUsreXxtZtiatHlACAfbQhv45as,38536
-sempy_labs/_vpax.py,sha256=k1UalPGdwmhL8eqH_WeOx1IkPu0Zz2xGWSBuAp4Sq0M,15432
+sempy_labs/_vpax.py,sha256=4rtXXGVoadvdu7uiU9PVsgKszST3XH-K56zmWdMmZEg,15471
 sempy_labs/_warehouses.py,sha256=wF38YP4-39KPsXPyexJahZPrYAyLc5xfrerJvS7My5Q,7286
 sempy_labs/_workloads.py,sha256=ifQ6Jv0_MDzjfu993bU8V7thOdW5kFyp3MjA082rsrE,4687
 sempy_labs/_workspace_identity.py,sha256=plxgcqt2aBXgLpyn1dpHhzh_5Z-gFkLK8RtId2OIX5s,2561
@@ -134,8 +136,8 @@ sempy_labs/graph/__init__.py,sha256=AZ_IpOL06VvXrYmgbcrvQlxCxdDksvwXKf7JAGohCNI,
 sempy_labs/graph/_groups.py,sha256=j3YDeV6MzhRjGJRoD60SAaGyU8yb23x8QhXBzU2RWlE,12590
 sempy_labs/graph/_teams.py,sha256=SRFaFuxtB7ylC5WeXIdrW0aLCxc_JTJHeEmxOPG99r8,3089
 sempy_labs/graph/_users.py,sha256=dFOZ-jel6Aj4Um66f1jzQrgV0fOoI0cQnZfmR4OJSXo,5947
-sempy_labs/lakehouse/__init__.py,sha256=xuYQAxBEEahNA_twvYxeP6cUd8dCreNb0eKyuKZbtPU,1327
-sempy_labs/lakehouse/_blobs.py,sha256=N8s3hYa9dAOLpH9iTavR_FPKrb3j_RqXHJnC6UVeeW0,9745
+sempy_labs/lakehouse/__init__.py,sha256=zKF6-rjy3UEClAlyW-koqrTK3_bAjU6WbDxKamsWCjs,1267
+sempy_labs/lakehouse/_blobs.py,sha256=K2uwzUUkYN1rGfpyQrubxWNjtM6AIWM9VVHh2_LYCTY,8483
 sempy_labs/lakehouse/_get_lakehouse_columns.py,sha256=dF5rLkdD3PB8EiXQewRdnr7MzbDGkZWHrFfI01_a7K4,3710
 sempy_labs/lakehouse/_get_lakehouse_tables.py,sha256=AMQXk40YMN4daS0zILgZm-sc2llnvCaL7kS1v8dfYMA,9369
 sempy_labs/lakehouse/_helper.py,sha256=W9adTkZw9_f9voB3bA2JWkI4LqAcnvpY929vMQJw1xE,7401
@@ -152,7 +154,7 @@ sempy_labs/migration/_migrate_tables_columns_to_semantic_model.py,sha256=HYi2vn7
 sempy_labs/migration/_migration_validation.py,sha256=AHURrWofb-U-L2Bdu36mcisVXOuZXi6Smgrrs2kjYBM,2650
 sempy_labs/migration/_refresh_calc_tables.py,sha256=qUBPZ5HAHyE5ev6STKDcmtEpRuLDX5RzYTKre4ZElj4,5443
 sempy_labs/report/_BPAReportTemplate.json,sha256=9Uh-7E6d2ooxQ7j5JRayv_ayEULc7Gzg42kZGKdOqH8,63920
-sempy_labs/report/__init__.py,sha256=bPZ_MMqKGokskjJwM3T89LxIVNa2AXJg8Lr-mvJhP0E,1392
+sempy_labs/report/__init__.py,sha256=yuMGbP7rd_50M-CRfIYR7BK8mPzpXXYzOPh9sBV-aqw,1434
 sempy_labs/report/_download_report.py,sha256=01hI26UV_jb5RLPheXRQsIDNNf4i72xICm14slKqEFA,2704
 sempy_labs/report/_export_report.py,sha256=XCMsZzTBMgvQOe3Ltdod7my7_izpmP-3AVH6W5CExPE,10976
 sempy_labs/report/_generate_report.py,sha256=S830woeisjKCYNyacfvSx0fVHzLC7-aw2oPIU2sYiP8,13910
@@ -160,10 +162,10 @@ sempy_labs/report/_paginated.py,sha256=rsElE0IQ9qxRDuEp6qNF1EcD5XEgfTc7WsWEQsals
 sempy_labs/report/_report_bpa.py,sha256=ClETB8Q41sY1scCuknhpvalvuBaQ9ZwA4QX7F3sPcjc,13596
 sempy_labs/report/_report_bpa_rules.py,sha256=tPVGA0hmE6QMLlWtig7Va7Ksr2yXWl_Lndq--tWWd6w,4959
 sempy_labs/report/_report_functions.py,sha256=pSrsUfMJqmsn9CYb5AM0iYdPR-EmuUSprVnc0dGhO1s,19709
-sempy_labs/report/_report_helper.py,sha256=m23osIZMjvHhKbfhmTHyqHibXoWA9eP84TPanbH8kuE,10863
+sempy_labs/report/_report_helper.py,sha256=L9wU0N0rvTUMglZHTxcowywrBDuZvZTv3DA4JrX84Os,7207
 sempy_labs/report/_report_list_functions.py,sha256=K9tMDQKhIZhelHvfMMW0lsxbVHekJ-5dAQveoD7PUDA,3980
 sempy_labs/report/_report_rebind.py,sha256=svyxUSdqgXJW1UDNcb-urJxU9erO3JM72uzmuJUWIT0,5090
-sempy_labs/report/_reportwrapper.py,sha256=itzDImW0XUJuQBL1gQpXjIRBk0Knic0VCf7MHw8Kt68,83421
+sempy_labs/report/_reportwrapper.py,sha256=YxGfhAXDkDyXuyyGYu5YpQf9S31L64Rpr3hHRE44fsk,108736
 sempy_labs/report/_save_report.py,sha256=FAzScMQIXl89TgVSRvaJofzKT0TfZh_hhPNNvDiktaI,6033
 sempy_labs/report/_bpareporttemplate/definition.pbir,sha256=bttyHZYKqjA8OBb_cezGlX4H82cDvGZVCl1QB3fij4E,343
 sempy_labs/report/_bpareporttemplate/StaticResources/SharedResources/BaseThemes/CY24SU06.json,sha256=4N6sT5nLlYBobGmZ1Xb68uOMVVCBEyheR535js_et28,13467
@@ -194,7 +196,7 @@ sempy_labs/report/_bpareporttemplate/definition/pages/d37dce724a0ccc30044b/page.
 sempy_labs/report/_bpareporttemplate/definition/pages/d37dce724a0ccc30044b/visuals/ce8532a7e25020271077/visual.json,sha256=mlY6t9OlSe-Y6_QmXJpS1vggU6Y3FjISUKECL8FVSg8,931
 sempy_labs/tom/__init__.py,sha256=Qbs8leW0fjzvWwOjyWK3Hjeehu7IvpB1beASGsi28bk,121
 sempy_labs/tom/_model.py,sha256=64IJf2Pdag5ECWxJcf4Cg2paoMD0Pr6BHvdjgvW6pwo,197537
-semantic_link_labs-0.9.11.dist-info/METADATA,sha256=93cuq3I17_DH0fWpnYNqB8YF8rckYYICQdRBtzN_SZs,26736
-semantic_link_labs-0.9.11.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-semantic_link_labs-0.9.11.dist-info/top_level.txt,sha256=kiQX1y42Dbein1l3Q8jMUYyRulDjdlc2tMepvtrvixQ,11
-semantic_link_labs-0.9.11.dist-info/RECORD,,
+semantic_link_labs-0.10.0.dist-info/METADATA,sha256=vw-G81gYnj_kJXcwm752EAY2d6TpwQ3QzDnjGYMkC3I,26831
+semantic_link_labs-0.10.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+semantic_link_labs-0.10.0.dist-info/top_level.txt,sha256=kiQX1y42Dbein1l3Q8jMUYyRulDjdlc2tMepvtrvixQ,11
+semantic_link_labs-0.10.0.dist-info/RECORD,,

{semantic_link_labs-0.9.11.dist-info → semantic_link_labs-0.10.0.dist-info}/WHEEL

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

sempy_labs/__init__.py

@@ -340,6 +340,9 @@ from sempy_labs._vertipaq import (
     vertipaq_analyzer,
     import_vertipaq_analyzer,
 )
+from sempy_labs._user_delegation_key import (
+    get_user_delegation_key,
+)
 
 __all__ = [
     "resolve_warehouse_id",
@@ -585,4 +588,5 @@ __all__ = [
     "update_semantic_model_refresh_schedule",
     "apply_tags",
     "unapply_tags",
+    "get_user_delegation_key",
 ]

sempy_labs/_dictionary_diffs.py

@@ -0,0 +1,221 @@
+import re
+import json
+import difflib
+from collections import defaultdict
+
+
+def color_text(text, color_code):
+    return f"\033[{color_code}m{text}\033[0m"
+
+
+def stringify(payload):
+    try:
+        if isinstance(payload, list):
+            return (
+                "[\n" + ",\n".join(f"  {json.dumps(item)}" for item in payload) + "\n]"
+            )
+        return json.dumps(payload, indent=2, sort_keys=True)
+    except Exception:
+        return str(payload)
+
+
+def extract_top_level_group(path):
+    # For something like: resourcePackages[1].items[1].name → resourcePackages[1].items[1]
+    segments = re.split(r"\.(?![^[]*\])", path)  # split on dots not in brackets
+    return ".".join(segments[:-1]) if len(segments) > 1 else segments[0]
+
+
+def get_by_path(obj, path):
+    """Navigate into nested dict/list based on a dot/bracket path like: a.b[1].c"""
+    tokens = re.findall(r"\w+|\[\d+\]", path)
+    for token in tokens:
+        if token.startswith("["):
+            index = int(token[1:-1])
+            obj = obj[index]
+        else:
+            obj = obj.get(token)
+    return obj
+
+
+def deep_diff(d1, d2, path=""):
+    diffs = []
+    if isinstance(d1, dict) and isinstance(d2, dict):
+        keys = set(d1) | set(d2)
+        for key in sorted(keys):
+            new_path = f"{path}.{key}" if path else key
+            if key not in d1:
+                diffs.append(("+", new_path, None, d2[key]))
+            elif key not in d2:
+                diffs.append(("-", new_path, d1[key], None))
+            else:
+                diffs.extend(deep_diff(d1[key], d2[key], new_path))
+    elif isinstance(d1, list) and isinstance(d2, list):
+        min_len = min(len(d1), len(d2))
+        list_changed = False
+        for i in range(min_len):
+            if d1[i] != d2[i]:
+                list_changed = True
+                break
+        if list_changed or len(d1) != len(d2):
+            diffs.append(("~", path, d1, d2))
+    elif d1 != d2:
+        diffs.append(("~", path, d1, d2))
+    return diffs
+
+
+def diff_parts(d1, d2):
+
+    def build_path_map(parts):
+        return {part["path"]: part["payload"] for part in parts}
+
+    try:
+        paths1 = build_path_map(d1)
+    except Exception:
+        paths1 = d1
+    try:
+        paths2 = build_path_map(d2)
+    except Exception:
+        paths2 = d2
+    all_paths = set(paths1) | set(paths2)
+
+    for part_path in sorted(all_paths):
+        p1 = paths1.get(part_path)
+        p2 = paths2.get(part_path)
+
+        if p1 is None:
+            print(color_text(f"+ {part_path}", "32"))  # Green
+            continue
+        elif p2 is None:
+            print(color_text(f"- {part_path}", "31"))  # Red
+            continue
+        elif p1 == p2:
+            continue
+
+        if p1 is None or p2 is None:
+            print(
+                color_text(f"+ {part_path}", "32")
+                if p2 and not p1
+                else color_text(f"- {part_path}", "31")
+            )
+            continue
+
+        # Header for the changed part
+        print(color_text(f"~ {part_path}", "33"))
+
+        # Collect diffs
+        diffs = deep_diff(p1, p2)
+        # If the diff is only a change of a whole list (like appending to a list), group it under its key
+        merged_list_diffs = []
+        for change_type, full_path, old_val, new_val in diffs:
+            if (
+                change_type == "~"
+                and isinstance(old_val, list)
+                and isinstance(new_val, list)
+            ):
+                merged_list_diffs.append((change_type, full_path, old_val, new_val))
+
+        # Replace individual item diffs with unified list diff
+        if merged_list_diffs:
+            diffs = merged_list_diffs
+
+        # Group diffs by common parent path (e.g. items[1])
+        grouped = defaultdict(list)
+        for change_type, full_path, old_val, new_val in diffs:
+            group_path = extract_top_level_group(full_path)
+            grouped[group_path].append((change_type, full_path, old_val, new_val))
+
+        # Print each group once with unified diff for the full substructure
+        for group_path in sorted(grouped):
+            print("  " + color_text(f"~ {group_path}", "33"))
+
+            try:
+                old_group = get_by_path(p1, group_path)
+                new_group = get_by_path(p2, group_path)
+            except Exception:
+                old_group = new_group = None
+
+            # Skip showing diffs for empty/null groups
+            if isinstance(old_group, dict) and isinstance(new_group, dict):
+                old_keys = set(old_group.keys())
+                new_keys = set(new_group.keys())
+
+                for key in sorted(old_keys - new_keys):
+                    print(
+                        "  "
+                        + color_text(f"- {key}: {json.dumps(old_group[key])}", "31")
+                    )
+                for key in sorted(new_keys - old_keys):
+                    print(
+                        "  "
+                        + color_text(f"+ {key}: {json.dumps(new_group[key])}", "32")
+                    )
+                for key in sorted(old_keys & new_keys):
+                    if old_group[key] != new_group[key]:
+                        print("  " + color_text(f"~ {key}:", "33"))
+                        old_val_str = stringify(old_group[key]).splitlines()
+                        new_val_str = stringify(new_group[key]).splitlines()
+                        for line in difflib.unified_diff(
+                            old_val_str,
+                            new_val_str,
+                            fromfile="old",
+                            tofile="new",
+                            lineterm="",
+                        ):
+                            if line.startswith("@@"):
+                                print("    " + color_text(line, "36"))
+                            elif line.startswith("-") and not line.startswith("---"):
+                                print("    " + color_text(line, "31"))
+                            elif line.startswith("+") and not line.startswith("+++"):
+                                print("    " + color_text(line, "32"))
+            elif old_group is None and new_group is not None:
+                if isinstance(new_group, dict):
+                    # print all added keys
+                    for key, val in new_group.items():
+                        print("  " + color_text(f"+ {key}: {json.dumps(val)}", "32"))
+                elif isinstance(new_group, list):
+                    old_str = []
+                    new_str = stringify(new_group).splitlines()
+                    for line in difflib.unified_diff(
+                        old_str, new_str, fromfile="old", tofile="new", lineterm=""
+                    ):
+                        if line.startswith("@@"):
+                            print("  " + color_text(line, "36"))
+                        elif line.startswith("-") and not line.startswith("---"):
+                            print("  " + color_text(line, "31"))
+                        elif line.startswith("+") and not line.startswith("+++"):
+                            print("  " + color_text(line, "32"))
+                else:
+                    print("  " + color_text(f"+ {json.dumps(new_group)}", "32"))
+
+            elif new_group is None and old_group is not None:
+                if isinstance(old_group, dict):
+                    # print all removed keys
+                    for key, val in old_group.items():
+                        print("  " + color_text(f"- {key}: {json.dumps(val)}", "31"))
+                elif isinstance(old_group, list):
+                    old_str = stringify(old_group).splitlines()
+                    new_str = []
+                    for line in difflib.unified_diff(
+                        old_str, new_str, fromfile="old", tofile="new", lineterm=""
+                    ):
+                        if line.startswith("@@"):
+                            print("  " + color_text(line, "36"))
+                        elif line.startswith("-") and not line.startswith("---"):
+                            print("  " + color_text(line, "31"))
+                        elif line.startswith("+") and not line.startswith("+++"):
+                            print("  " + color_text(line, "32"))
+                else:
+                    print("  " + color_text(f"- {json.dumps(old_group)}", "31"))
+            else:
+                old_str = stringify(old_group).splitlines()
+                new_str = stringify(new_group).splitlines()
+
+                for line in difflib.unified_diff(
+                    old_str, new_str, fromfile="old", tofile="new", lineterm=""
+                ):
+                    if line.startswith("@@"):
+                        print("  " + color_text(line, "36"))
+                    elif line.startswith("-") and not line.startswith("---"):
+                        print("  " + color_text(line, "31"))
+                    elif line.startswith("+") and not line.startswith("+++"):
+                        print("  " + color_text(line, "32"))

sempy_labs/_helper_functions.py

@@ -17,6 +17,8 @@ import numpy as np
 from IPython.display import display, HTML
 import requests
 import sempy_labs._authentication as auth
+from jsonpath_ng.ext import parse
+from jsonpath_ng.jsonpath import Fields, Index
 
 
 def _build_url(url: str, params: dict) -> str:
@@ -2270,3 +2272,166 @@ def file_exists(file_path: str) -> bool:
     import notebookutils
 
     return len(notebookutils.fs.ls(file_path)) > 0
+
+
+def generate_number_guid():
+
+    guid = uuid.uuid4()
+    return str(guid.int & ((1 << 64) - 1))
+
+
+def get_url_content(url: str):
+
+    if "github.com" in url and "/blob/" in url:
+        url = url.replace("github.com", "raw.githubusercontent.com")
+        url = url.replace("/blob/", "/")
+
+    response = requests.get(url)
+    if response.ok:
+        try:
+            data = response.json()  # Only works if the response is valid JSON
+        except ValueError:
+            data = response.text  # Fallback: get raw text content
+        return data
+    else:
+        print(f"Failed to fetch raw content: {response.status_code}")
+
+
+def generate_hex(length: int = 10) -> str:
+    """
+    Generate a random hex string of the specified length. Used for generating IDs for report objects (page, visual, bookmark etc.).
+    """
+    import secrets
+
+    return secrets.token_hex(length)
+
+
+def decode_payload(payload):
+
+    if is_base64(payload):
+        try:
+            decoded_payload = json.loads(base64.b64decode(payload).decode("utf-8"))
+        except Exception:
+            decoded_payload = base64.b64decode(payload)
+    elif isinstance(payload, dict):
+        decoded_payload = payload
+    else:
+        raise ValueError("Payload must be a dictionary or a base64 encoded value.")
+
+    return decoded_payload
+
+
+def is_base64(s):
+    try:
+        # Add padding if needed
+        s_padded = s + "=" * (-len(s) % 4)
+        decoded = base64.b64decode(s_padded, validate=True)
+        # Optional: check if re-encoding gives the original (excluding padding)
+        return base64.b64encode(decoded).decode().rstrip("=") == s.rstrip("=")
+    except Exception:
+        return False
+
+
+def get_jsonpath_value(
+    data, path, default=None, remove_quotes=False, fix_true: bool = False
+):
+    matches = parse(path).find(data)
+    result = matches[0].value if matches else default
+    if result and remove_quotes and isinstance(result, str):
+        if result.startswith("'") and result.endswith("'"):
+            result = result[1:-1]
+    if fix_true and isinstance(result, str):
+        if result.lower() == "true":
+            result = True
+        elif result.lower() == "false":
+            result = False
+    return result
+
+
+def set_json_value(payload: dict, json_path: str, json_value: str | dict | List):
+
+    jsonpath_expr = parse(json_path)
+    matches = jsonpath_expr.find(payload)
+
+    if matches:
+        # Update all matches
+        for match in matches:
+            parent = match.context.value
+            path = match.path
+            if isinstance(path, Fields):
+                parent[path.fields[0]] = json_value
+            elif isinstance(path, Index):
+                parent[path.index] = json_value
+    else:
+        # Handle creation
+        parts = json_path.lstrip("$").strip(".").split(".")
+        current = payload
+
+        for i, part in enumerate(parts):
+            is_last = i == len(parts) - 1
+
+            # Detect list syntax like "lockAspect[*]"
+            list_match = re.match(r"(\w+)\[\*\]", part)
+            if list_match:
+                list_key = list_match.group(1)
+                if list_key not in current or not isinstance(current[list_key], list):
+                    # Initialize with one dict element
+                    current[list_key] = [{}]
+
+                for item in current[list_key]:
+                    if is_last:
+                        # Last part, assign value
+                        item = json_value
+                    else:
+                        # Proceed to next level
+                        if not isinstance(item, dict):
+                            raise ValueError(
+                                f"Expected dict in list for key '{list_key}', got {type(item)}"
+                            )
+                        next_part = ".".join(parts[i + 1 :])
+                        set_json_value(item, "$." + next_part, json_value)
+                return payload
+            else:
+                if part not in current or not isinstance(current[part], dict):
+                    current[part] = {} if not is_last else json_value
+                elif is_last:
+                    current[part] = json_value
+                current = current[part]
+
+    return payload
+
+
+def remove_json_value(path: str, payload: dict, json_path: str, verbose: bool = True):
+
+    if not isinstance(payload, dict):
+        raise ValueError(
+            f"{icons.red_dot} Cannot apply json_path to non-dictionary payload in '{path}'."
+        )
+
+    jsonpath_expr = parse(json_path)
+    matches = jsonpath_expr.find(payload)
+
+    if not matches and verbose:
+        print(
+            f"{icons.red_dot} No match found for '{json_path}' in '{path}'. Skipping."
+        )
+        return payload
+
+    for match in matches:
+        parent = match.context.value
+        path_expr = match.path
+
+        if isinstance(path_expr, Fields):
+            key = path_expr.fields[0]
+            if key in parent:
+                del parent[key]
+                if verbose:
+                    print(f"{icons.green_dot} Removed key '{key}' from '{path}'.")
+        elif isinstance(path_expr, Index):
+            index = path_expr.index
+            if isinstance(parent, list) and 0 <= index < len(parent):
+                parent.pop(index)
+                if verbose:
+                    print(f"{icons.green_dot} Removed index [{index}] from '{path}'.")
+
+    return payload

sempy_labs/_sql.py

@@ -82,7 +82,7 @@ class ConnectBase:
             )
 
         # Set up the connection string
-        access_token = SynapseTokenProvider()()
+        access_token = SynapseTokenProvider()("sql")
         tokenstruct = _bytes2mswin_bstr(access_token.encode())
         if endpoint_type == "sqldatabase":
             conn_str = f"DRIVER={{ODBC Driver 18 for SQL Server}};SERVER={tds_endpoint};DATABASE={resource_name}-{resource_id};Encrypt=Yes;"

sempy_labs/_user_delegation_key.py

@@ -0,0 +1,42 @@
+from sempy_labs.lakehouse._blobs import _request_blob_api
+from sempy_labs._helper_functions import (
+    _xml_to_dict,
+)
+from datetime import datetime, timedelta, timezone
+import xml.etree.ElementTree as ET
+
+
+def get_user_delegation_key():
+    """
+    Gets a key that can be used to sign a user delegation SAS (shared access signature). A user delegation SAS grants access to Azure Blob Storage resources by using Microsoft Entra credentials.
+
+    This is a wrapper function for the following API: `Get User Delegation Key <https://learn.microsoft.com/rest/api/storageservices/get-user-delegation-key>`_.
+
+    Returns
+    -------
+    str
+        The user delegation key value.
+    """
+
+    utc_now = datetime.now(timezone.utc)
+    start_time = utc_now + timedelta(minutes=2)
+    expiry_time = start_time + timedelta(minutes=60)
+    start_str = start_time.strftime("%Y-%m-%dT%H:%M:%SZ")
+    expiry_str = expiry_time.strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    payload = f"""<?xml version="1.0" encoding="utf-8"?>
+    <KeyInfo>
+        <Start>{start_str}</Start>
+        <Expiry>{expiry_str}</Expiry>
+    </KeyInfo>"""
+
+    response = _request_blob_api(
+        request="?restype=service&comp=userdelegationkey",
+        method="post",
+        payload=payload,
+    )
+
+    root = ET.fromstring(response.content)
+    response_json = _xml_to_dict(root)
+
+    return response_json.get("UserDelegationKey", {}).get("Value", None)

sempy_labs/_vpax.py

@@ -16,6 +16,7 @@ from sempy_labs._helper_functions import (
     file_exists,
     create_abfss_path_from_path,
 )
+from sempy._utils._log import log
 import sempy_labs._icons as icons
 import zipfile
 import requests
@@ -134,6 +135,7 @@ def init_vertipaq_analyzer():
     _vpa_initialized = True
 
 
+@log
 def create_vpax(
     dataset: str | UUID,
     workspace: Optional[str | UUID] = None,

sempy_labs/lakehouse/__init__.py

@@ -20,7 +20,6 @@ from sempy_labs.lakehouse._shortcuts import (
 from sempy_labs.lakehouse._blobs import (
     recover_lakehouse_object,
     list_blobs,
-    get_user_delegation_key,
 )
 from sempy_labs.lakehouse._livy_sessions import (
     list_livy_sessions,
@@ -51,5 +50,4 @@ __all__ = [
     "delete_lakehouse",
     "update_lakehouse",
     "load_table",
-    "get_user_delegation_key",
 ]

sempy_labs/lakehouse/_blobs.py

@@ -244,40 +244,3 @@ def recover_lakehouse_object(
             print(
                 f"{icons.red_dot} An error occurred while recovering the '{blob_name}' blob: {e}"
             )
-
-
-def get_user_delegation_key():
-    """
-    Gets a key that can be used to sign a user delegation SAS (shared access signature). A user delegation SAS grants access to Azure Blob Storage resources by using Microsoft Entra credentials.
-
-    This is a wrapper function for the following API: `Get User Delegation Key <https://learn.microsoft.com/rest/api/storageservices/get-user-delegation-key>`_.
-
-    Returns
-    -------
-    str
-        The user delegation key value.
-    """
-
-    from datetime import datetime, timedelta, timezone
-
-    utc_now = datetime.now(timezone.utc)
-    start_time = utc_now + timedelta(minutes=2)
-    expiry_time = start_time + timedelta(minutes=60)
-    start_str = start_time.strftime("%Y-%m-%dT%H:%M:%SZ")
-    expiry_str = expiry_time.strftime("%Y-%m-%dT%H:%M:%SZ")
-
-    payload = f"""<?xml version="1.0" encoding="utf-8"?>
-    <KeyInfo>
-        <Start>{start_str}</Start>
-        <Expiry>{expiry_str}</Expiry>
-    </KeyInfo>"""
-
-    response = _request_blob_api(
-        request="?restype=service&comp=userdelegationkey",
-        method="post",
-        payload=payload,
-    )
-
-    root = ET.fromstring(response.content)
-    response_json = _xml_to_dict(root)
-    return response_json.get("UserDelegationKey", {}).get("Value", None)