semantic-link-labs 0.12.0__py3-none-any.whl → 0.12.2__py3-none-any.whl

sempy_labs/graph/_users.py

@@ -301,3 +301,165 @@ def send_mail(
     if attachments:
         printout += f" with {len(attachments)} attachment(s)"
     print(f"{printout}.")
+
+
+@log
+def create_user(
+    display_name: str,
+    user_principal_name: str,
+    mail_nickname: str,
+    password: str,
+    account_enabled: bool = True,
+    force_change_password_next_sign_in: bool = True,
+):
+    """
+    Creates a new user.
+
+    This is a wrapper function for the following API: `Create User <https://learn.microsoft.com/graph/api/user-post-users>`_.
+
+    Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    display_name : str
+        The name to display in the address book for the user.
+    user_principal_name : str
+        The user principal name (someuser@contoso.com).
+    mail_nickname : str
+        The mail alias for the user.
+    password : str
+        The initial password for the user.
+    account_enabled : bool, default=True
+        Whether the account is enabled. Default is True.
+    force_change_password_next_sign_in : bool, default=True
+        Whether the user must change their password on next sign-in. Default is True.
+    """
+
+    payload = {
+        "accountEnabled": account_enabled,
+        "displayName": display_name,
+        "mailNickname": mail_nickname,
+        "userPrincipalName": user_principal_name,
+        "passwordProfile": {
+            "forceChangePasswordNextSignIn": force_change_password_next_sign_in,
+            "password": password,
+        },
+    }
+
+    _base_api(
+        request="users",
+        client="graph",
+        status_codes=201,
+        payload=payload,
+        method="post",
+    )
+
+    print(f"{icons.green_dot} The '{display_name}' user has been created successfully.")
+
+
+@log
+def delete_user(user: str | UUID):
+    """
+    Deletes a user.
+
+    This is a wrapper function for the following API: `Delete User <https://learn.microsoft.com/graph/api/user-delete>`_.
+
+    Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user : str | uuid.UUID
+        The user name or ID.
+    """
+
+    user_id = resolve_user_id(user)
+
+    _base_api(
+        request=f"users/{user_id}",
+        client="graph",
+        status_codes=204,
+        method="delete",
+    )
+
+    print(f"{icons.green_dot} The '{user}' user has been deleted successfully.")
+
+
+@log
+def update_user(
+    user: str | UUID,
+    display_name: Optional[str] = None,
+    user_principal_name: Optional[str] = None,
+    given_name: Optional[str] = None,
+    surname: Optional[str] = None,
+    job_title: Optional[str] = None,
+    mail_nickname: Optional[str] = None,
+    my_site: Optional[str] = None,
+    office_location: Optional[str] = None,
+    account_enabled: Optional[bool] = None,
+):
+    """
+    Updates a user's properties.
+
+    This is a wrapper function for the following API: `Update user <https://learn.microsoft.com/graph/api/user-update>`_.
+
+    Service Principal Authentication is required (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    user : str | uuid.UUID
+        The user name or ID.
+    display_name : str, default=None
+        The name displayed in the address book for the user.
+    user_principal_name : str, default=None
+        The user principal name (UPN) of the user.
+    given_name : str, default=None
+        The given name (first name) of the user.
+    surname : str, default=None
+        The user's surname (family name or last name).
+    job_title : str, default=None
+        The user's job title.
+    mail_nickname : str, default=None
+        The mail alias for the user. This property must be specified when a user is created.
+    my_site : str, default=None
+        The URL for the user's personal site.
+    office_location : str, default=None
+        The office location in the user's place of business.
+    account_enabled : bool, default=None
+        Whether the account is enabled. If None, the property will not be updated.
+    """
+
+    user_id = resolve_user_id(user)
+
+    payload = {}
+    if display_name is not None:
+        payload["displayName"] = display_name
+    if mail_nickname is not None:
+        payload["mailNickname"] = mail_nickname
+    if user_principal_name is not None:
+        payload["userPrincipalName"] = user_principal_name
+    if given_name is not None:
+        payload["givenName"] = given_name
+    if job_title is not None:
+        payload["jobTitle"] = job_title
+    if my_site is not None:
+        payload["mySite"] = my_site
+    if office_location is not None:
+        payload["officeLocation"] = office_location
+    if surname is not None:
+        payload["surname"] = surname
+    if account_enabled is not None and isinstance(account_enabled, bool):
+        payload["accountEnabled"] = account_enabled
+
+    if not payload:
+        print(f"{icons.info} No properties to update.")
+        return
+
+    _base_api(
+        request=f"users/{user_id}",
+        client="graph",
+        status_codes=204,
+        payload=payload,
+        method="patch",
+    )
+
+    print(f"{icons.green_dot} The '{user}' user has been updated successfully.")

sempy_labs/lakehouse/_shortcuts.py

@@ -396,17 +396,22 @@ def list_shortcuts(
             # Cache and use it to getitem type and name
             source_item_type = None
             source_item_name = None
-            dfI = source_items_df[
-                source_items_df["Workspace Id"] == source_workspace_id
-            ]
-            if dfI.empty:
-                dfI = fabric.list_items(workspace=source_workspace_id)
-                source_items_df = pd.concat([source_items_df, dfI], ignore_index=True)
-
-            dfI_filt = dfI[dfI["Id"] == source_item_id]
-            if not dfI_filt.empty:
-                source_item_type = dfI_filt["Type"].iloc[0]
-                source_item_name = dfI_filt["Display Name"].iloc[0]
+            try:
+                dfI = source_items_df[
+                    source_items_df["Workspace Id"] == source_workspace_id
+                ]
+                if dfI.empty:
+                    dfI = fabric.list_items(workspace=source_workspace_id)
+                    source_items_df = pd.concat(
+                        [source_items_df, dfI], ignore_index=True
+                    )
+
+                dfI_filt = dfI[dfI["Id"] == source_item_id]
+                if not dfI_filt.empty:
+                    source_item_type = dfI_filt["Type"].iloc[0]
+                    source_item_name = dfI_filt["Display Name"].iloc[0]
+            except Exception:
+                pass
 
             rows.append(
                 {

sempy_labs/report/_report_rebind.py

@@ -12,8 +12,8 @@ from uuid import UUID
 
 @log
 def report_rebind(
-    report: str | List[str],
-    dataset: str,
+    report: str | UUID | List[str | UUID],
+    dataset: str | UUID,
     report_workspace: Optional[str | UUID] = None,
     dataset_workspace: Optional[str | UUID] = None,
 ):
@@ -77,47 +77,50 @@ def report_rebind(
 
 @log
 def report_rebind_all(
-    dataset: str,
-    new_dataset: str,
-    dataset_workspace: Optional[str] = None,
-    new_dataset_workpace: Optional[str] = None,
-    report_workspace: Optional[str | List[str]] = None,
+    dataset: str | UUID,
+    new_dataset: str | UUID,
+    dataset_workspace: Optional[str | UUID] = None,
+    new_dataset_workspace: Optional[str | UUID] = None,
+    report_workspace: Optional[str | UUID | List[str | UUID]] = None,
 ):
     """
-    Rebinds all reports across all workspaces which are bound to a specific semantic model to a new semantic model.
+    Rebinds all reports across the provided report workspaces which are bound to a specific semantic model to a new semantic model.
 
     Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
 
     Parameters
     ----------
-    dataset : str
+    dataset : str | uuid.UUID
         Name of the semantic model currently binded to the reports.
-    new_dataset : str
+    new_dataset : str | uuid.UUID
         Name of the semantic model to rebind to the reports.
-    dataset_workspace : str, default=None
+    dataset_workspace : str | uuid.UUID, default=None
         The name of the Fabric workspace in which the original semantic model resides.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
-    new_dataset_workspace : str, default=None
+    new_dataset_workspace : str | uuid.UUID, default=None
         The name of the Fabric workspace in which the new semantic model resides.
         Defaults to None which resolves to the workspace of the attached lakehouse
         or if no lakehouse attached, resolves to the workspace of the notebook.
-    report_workspace : str | List[str], default=None
-        The name(s) of the Fabric workspace(s) in which the report(s) reside(s).
+    report_workspace : str | uuid.UUID | List[str | uuid.UUID], default=None
+        The name(s) or IDs of the Fabric workspace(s) in which the report(s) reside(s).
         Defaults to None which finds all reports in all workspaces which use the semantic model and rebinds them to
         the new semantic model.
     """
 
     from sempy_labs._list_functions import list_reports_using_semantic_model
 
-    if dataset == new_dataset:
-        raise ValueError(
-            f"{icons.red_dot} The 'dataset' and 'new_dataset' parameters are both set to '{dataset}'. These parameters must be set to different values."
-        )
-
     (dataset_name, dataset_id) = resolve_dataset_name_and_id(
         dataset=dataset, workspace=dataset_workspace
     )
+    (new_dataset_name, new_dataset_id) = resolve_dataset_name_and_id(
+        dataset=new_dataset, workspace=new_dataset_workspace
+    )
+
+    if dataset_id == new_dataset_id:
+        raise ValueError(
+            f"{icons.red_dot} The 'dataset' and 'new_dataset' parameters are both set to '{dataset}'. These parameters must be set to different values."
+        )
     (dataset_workspace_name, dataset_workspace_id) = resolve_workspace_name_and_id(
         workspace=dataset_workspace
     )
@@ -129,7 +132,7 @@ def report_rebind_all(
         dataset=dataset, workspace=dataset_workspace
     )
 
-    if len(dfR) == 0:
+    if dfR.empty:
         print(
             f"{icons.info} The '{dataset_name}' semantic model within the '{dataset_workspace_name}' workspace has no dependent reports."
         )
@@ -138,9 +141,18 @@ def report_rebind_all(
     if report_workspace is None:
         dfR_filt = dfR.copy()
     else:
-        dfR_filt = dfR[dfR["Report Workspace Name"].isin(report_workspace)]
+        dfR_filt = dfR[
+            (dfR["Report Workspace Name"].isin(report_workspace))
+            | (dfR["Report Workspace ID"].isin(report_workspace))
+        ]
+
+    if dfR_filt.empty:
+        print(
+            f"{icons.info} No reports found for the '{dataset_name}' semantic model within the '{dataset_workspace_name}' workspace."
+        )
+        return
 
-    for i, r in dfR_filt.iterrows():
+    for _, r in dfR_filt.iterrows():
         rpt_name = r["Report Name"]
         rpt_wksp = r["Report Workspace Name"]
 
@@ -148,5 +160,5 @@ def report_rebind_all(
             report=rpt_name,
             dataset=new_dataset,
             report_workspace=rpt_wksp,
-            dataset_workspace=new_dataset_workpace,
+            dataset_workspace=new_dataset_workspace,
         )

sempy_labs/report/_reportwrapper.py

@@ -935,9 +935,6 @@ class ReportWrapper:
         """
         Shows a list of all modified `visual interactions <https://learn.microsoft.com/power-bi/create-reports/service-reports-visual-interactions?tabs=powerbi-desktop>`_ used in the report.
 
-        Parameters
-        ----------
-
         Returns
         -------
         pandas.DataFrame
@@ -980,6 +977,56 @@ class ReportWrapper:
 
         return df
 
+    def list_visual_calculations(self) -> pd.DataFrame:
+        """
+        Shows a list of all `visual calculations <https://learn.microsoft.com/power-bi/transform-model/desktop-visual-calculations-overview>`_.
+
+        Returns
+        -------
+        pandas.DataFrame
+            A pandas dataframe containing a list of all visual calculations within the report.
+        """
+
+        self._ensure_pbir()
+
+        columns = {
+            "Page Display Name": "str",
+            "Visual Name": "str",
+            "Name": "str",
+            "Language": "str",
+            "Expression": "str",
+        }
+
+        df = _create_dataframe(columns=columns)
+        visual_mapping = self._visual_page_mapping()
+
+        rows = []
+        for v in self.__all_visuals():
+            path = v.get("path")
+            payload = v.get("payload")
+            page_name = visual_mapping.get(path)[0]
+            page_display_name = visual_mapping.get(path)[1]
+            visual_name = payload.get("name")
+            matches = parse("$..field.NativeVisualCalculation").find(payload)
+            if matches:
+                for match in matches:
+                    m = match.value
+                    rows.append(
+                        {
+                            "Page Display Name": page_display_name,
+                            "Page Name": page_name,
+                            "Visual Name": visual_name,
+                            "Name": m.get("Name"),
+                            "Language": m.get("Language"),
+                            "Expression": m.get("Expression"),
+                        }
+                    )
+
+        if rows:
+            df = pd.DataFrame(rows, columns=list(columns.keys()))
+
+        return df
+
     def list_pages(self) -> pd.DataFrame:
         """
         Shows a list of all pages in the report.
@@ -1651,7 +1698,7 @@ class ReportWrapper:
         bookmarks = [
             o
             for o in self._report_definition.get("parts")
-            if o.get("path").endswith("/bookmark.json")
+            if o.get("path").endswith(".bookmark.json")
         ]
 
         rows = []
@@ -2069,8 +2116,8 @@ class ReportWrapper:
         df = dfCV[dfCV["Used in Report"] == False]
 
         if not df.empty:
-            cv_remove = df["Custom Visual Name"].values()
-            cv_remove_display = df["Custom Visual Display Name"].values()
+            cv_remove = df["Custom Visual Name"].values
+            cv_remove_display = df["Custom Visual Display Name"].values
         else:
             print(
                 f"{icons.red_dot} There are no unnecessary custom visuals in the '{self._report_name}' report within the '{self._workspace_name}' workspace."

sempy_labs/tom/_model.py

@@ -6,7 +6,7 @@ import os
 import json
 from datetime import datetime
 from decimal import Decimal
-from .._helper_functions import (
+from sempy_labs._helper_functions import (
     format_dax_object_name,
     generate_guid,
     _make_list_unique,
@@ -17,10 +17,11 @@ from .._helper_functions import (
     resolve_item_id,
     resolve_lakehouse_id,
     _validate_weight,
+    _get_url_prefix,
 )
-from .._list_functions import list_relationships
-from .._refresh_semantic_model import refresh_semantic_model
-from ..directlake._dl_helper import check_fallback_reason
+from sempy_labs._list_functions import list_relationships
+from sempy_labs._refresh_semantic_model import refresh_semantic_model
+from sempy_labs.directlake._dl_helper import check_fallback_reason
 from contextlib import contextmanager
 from typing import List, Iterator, Optional, Union, TYPE_CHECKING, Literal
 from sempy._utils._log import log
@@ -28,7 +29,9 @@ import sempy_labs._icons as icons
 import ast
 from uuid import UUID
 import sempy_labs._authentication as auth
-from ..lakehouse._lakehouse import lakehouse_attached
+from sempy_labs.lakehouse._lakehouse import lakehouse_attached
+import requests
+from sempy.fabric.exceptions import FabricHTTPException
 
 
 if TYPE_CHECKING:
@@ -4601,8 +4604,12 @@ class TOMWrapper:
         pandas.DataFrame
             A pandas dataframe showing the updated measure(s) and their new description(s).
         """
+        import notebookutils
+
         icons.sll_tags.append("GenerateMeasureDescriptions")
 
+        prefix = _get_url_prefix()
+
         df = pd.DataFrame(
             columns=["Table Name", "Measure Name", "Expression", "Description"]
         )
@@ -4655,11 +4662,17 @@ class TOMWrapper:
                     "modelItems"
                 ].append(new_item)
 
-            response = _base_api(
-                request="/explore/v202304/nl2nl/completions",
-                method="post",
-                payload=payload,
+            token = notebookutils.credentials.getToken("pbi")
+            headers = {"Authorization": f"Bearer {token}"}
+            response = requests.post(
+                f"{prefix}/explore/v202304/nl2nl/completions",
+                headers=headers,
+                json=payload,
             )
+            if response.status_code != 200:
+                raise FabricHTTPException(
+                    f"Failed to retrieve descriptions: {response.text}"
+                )
 
             for item in response.json().get("modelItems", []):
                 ms_name = item["urn"]