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

sempy_labs/admin/_datasets.py

@@ -9,8 +9,10 @@ from sempy_labs._helper_functions import (
 )
 from uuid import UUID
 import sempy_labs._icons as icons
+from sempy._utils._log import log
 
 
+@log
 def list_datasets(
     top: Optional[int] = None,
     filter: Optional[str] = None,
@@ -77,46 +79,45 @@ def list_datasets(
     url = _build_url(url, params)
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "Dataset Id": v.get("id"),
-                "Dataset Name": v.get("name"),
-                "Web URL": v.get("webUrl"),
-                "Add Rows API Enabled": v.get("addRowsAPIEnabled"),
-                "Configured By": v.get("configuredBy"),
-                "Is Refreshable": v.get("isRefreshable"),
-                "Is Effective Identity Required": v.get("isEffectiveIdentityRequired"),
-                "Is Effective Identity Roles Required": v.get(
-                    "isEffectiveIdentityRolesRequired"
-                ),
-                "Target Storage Mode": v.get("targetStorageMode"),
-                "Created Date": pd.to_datetime(v.get("createdDate")),
-                "Content Provider Type": v.get("contentProviderType"),
-                "Create Report Embed URL": v.get("createReportEmbedURL"),
-                "QnA Embed URL": v.get("qnaEmbedURL"),
-                "Upstream Datasets": v.get("upstreamDatasets", []),
-                "Users": v.get("users", []),
-                "Is In Place Sharing Enabled": v.get("isInPlaceSharingEnabled"),
-                "Workspace Id": v.get("workspaceId"),
-                "Auto Sync Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
-                    "autoSyncReadOnlyReplicas"
-                ),
-                "Max Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
-                    "maxReadOnlyReplicas"
-                ),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "Dataset Id": v.get("id"),
+            "Dataset Name": v.get("name"),
+            "Web URL": v.get("webUrl"),
+            "Add Rows API Enabled": v.get("addRowsAPIEnabled"),
+            "Configured By": v.get("configuredBy"),
+            "Is Refreshable": v.get("isRefreshable"),
+            "Is Effective Identity Required": v.get("isEffectiveIdentityRequired"),
+            "Is Effective Identity Roles Required": v.get(
+                "isEffectiveIdentityRolesRequired"
+            ),
+            "Target Storage Mode": v.get("targetStorageMode"),
+            "Created Date": pd.to_datetime(v.get("createdDate")),
+            "Content Provider Type": v.get("contentProviderType"),
+            "Create Report Embed URL": v.get("createReportEmbedURL"),
+            "QnA Embed URL": v.get("qnaEmbedURL"),
+            "Upstream Datasets": v.get("upstreamDatasets", []),
+            "Users": v.get("users", []),
+            "Is In Place Sharing Enabled": v.get("isInPlaceSharingEnabled"),
+            "Workspace Id": v.get("workspaceId"),
+            "Auto Sync Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
+                "autoSyncReadOnlyReplicas"
+            ),
+            "Max Read Only Replicas": v.get("queryScaleOutSettings", {}).get(
+                "maxReadOnlyReplicas"
+            ),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def _resolve_dataset_id(dataset: str | UUID) -> str:
     if _is_valid_uuid(dataset):
         return dataset
@@ -128,6 +129,7 @@ def _resolve_dataset_id(dataset: str | UUID) -> str:
         return df_filt["Dataset Id"].iloc[0]
 
 
+@log
 def list_dataset_users(dataset: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified dataset.
@@ -163,22 +165,20 @@ def list_dataset_users(dataset: str | UUID) -> pd.DataFrame:
     url = f"/v1.0/myorg/admin/datasets/{dataset_id}/users"
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "Dataset User Access Right": v.get("datasetUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "Dataset User Access Right": v.get("datasetUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_domains.py

@@ -8,8 +8,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
     _is_valid_uuid,
 )
+from sempy._utils._log import log
 
 
+@log
 def resolve_domain_id(domain: Optional[str | UUID] = None, **kwargs) -> UUID:
     """
     Obtains the domain Id for a given domain name.
@@ -45,6 +47,7 @@ def resolve_domain_id(domain: Optional[str | UUID] = None, **kwargs) -> UUID:
     return dfL_filt["Domain ID"].iloc[0]
 
 
+@log
 def resolve_domain_name(domain: Optional[str | UUID], **kwargs) -> UUID:
     """
     Obtains the domain name for a given domain ID.
@@ -80,6 +83,7 @@ def resolve_domain_name(domain: Optional[str | UUID], **kwargs) -> UUID:
     return dfL_filt["Domain Name"].iloc[0]
 
 
+@log
 def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
     """
     Shows a list of domains.
@@ -115,6 +119,7 @@ def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
 
     response = _base_api(request=url, client="fabric_sp")
 
+    dfs = []
     for v in response.json().get("domains", []):
         new_data = {
             "Domain ID": v.get("id"),
@@ -123,11 +128,15 @@ def list_domains(non_empty_only: bool = False) -> pd.DataFrame:
             "Parent Domain ID": v.get("parentDomainId"),
             "Contributors Scope": v.get("contributorsScope"),
         }
-        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     return df
 
 
+@log
 def list_domain_workspaces(domain: Optional[str] = None, **kwargs) -> pd.DataFrame:
     """
     Shows a list of workspaces within the domain.
@@ -178,6 +187,7 @@ def list_domain_workspaces(domain: Optional[str] = None, **kwargs) -> pd.DataFra
     return df
 
 
+@log
 def create_domain(
     domain_name: str,
     description: Optional[str] = None,
@@ -222,6 +232,7 @@ def create_domain(
     print(f"{icons.green_dot} The '{domain_name}' domain has been created.")
 
 
+@log
 def delete_domain(domain: Optional[str | UUID], **kwargs):
     """
     Deletes a domain.
@@ -249,6 +260,7 @@ def delete_domain(domain: Optional[str | UUID], **kwargs):
     print(f"{icons.green_dot} The '{domain}' domain has been deleted.")
 
 
+@log
 def update_domain(
     domain: Optional[str | UUID] = None,
     description: Optional[str] = None,
@@ -301,6 +313,7 @@ def update_domain(
     print(f"{icons.green_dot} The '{domain_name}' domain has been updated.")
 
 
+@log
 def assign_domain_workspaces_by_capacities(
     domain: str | UUID,
     capacity_names: str | List[str],
@@ -369,6 +382,7 @@ def assign_domain_workspaces_by_capacities(
     )
 
 
+@log
 def assign_domain_workspaces(domain: str | UUID, workspace_names: str | List[str]):
     """
     Assigns workspaces to the specified domain by workspace.
@@ -420,6 +434,7 @@ def assign_domain_workspaces(domain: str | UUID, workspace_names: str | List[str
     )
 
 
+@log
 def unassign_all_domain_workspaces(domain: str | UUID):
     """
     Unassigns all workspaces from the specified domain.
@@ -446,6 +461,7 @@ def unassign_all_domain_workspaces(domain: str | UUID):
     )
 
 
+@log
 def unassign_domain_workspaces(
     domain: str | UUID,
     workspace_names: str | List[str],

sempy_labs/admin/_external_data_share.py

@@ -7,8 +7,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
     _update_dataframe_datatypes,
 )
+from sempy._utils._log import log
 
 
+@log
 def list_external_data_shares() -> pd.DataFrame:
     """
     Lists external data shares in the tenant. This function is for admins.
@@ -39,6 +41,7 @@ def list_external_data_shares() -> pd.DataFrame:
 
     response = _base_api(request="/v1/admin/items/externalDataShares")
 
+    dfs = []
     for i in response.json().get("value", []):
         cp = i.get("creatorPrincipal", {})
         new_data = {
@@ -56,13 +59,16 @@ def list_external_data_shares() -> pd.DataFrame:
             "Invitation URL": i.get("invitationUrl"),
         }
 
-        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def revoke_external_data_share(
     external_data_share_id: UUID, item_id: UUID, workspace: str | UUID
 ):

sempy_labs/admin/_git.py

@@ -4,8 +4,10 @@ from sempy_labs._helper_functions import (
 )
 import pandas as pd
 from sempy_labs.admin._basic_functions import list_workspaces
+from sempy._utils._log import log
 
 
+@log
 def list_git_connections() -> pd.DataFrame:
     """
     Shows a list of Git connections.
@@ -38,6 +40,7 @@ def list_git_connections() -> pd.DataFrame:
         uses_pagination=True,
     )
 
+    dfs = []
     for r in responses:
         for v in r.get("value", []):
             git = v.get("gitProviderDetails", {})
@@ -52,16 +55,18 @@ def list_git_connections() -> pd.DataFrame:
                 "Directory Name": git.get("directoryName"),
             }
 
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    dfW = list_workspaces()
-    df = pd.merge(
-        df, dfW[["Id", "Name"]], left_on="Workspace Id", right_on="Id", how="left"
-    )
-    new_col_name = "Workspace Name"
-    df = df.rename(columns={"Name": new_col_name})
-    df.insert(1, new_col_name, df.pop(new_col_name))
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        dfW = list_workspaces()
+        df = pd.merge(
+            df, dfW[["Id", "Name"]], left_on="Workspace Id", right_on="Id", how="left"
+        )
+        new_col_name = "Workspace Name"
+        df = df.rename(columns={"Name": new_col_name})
+        df.insert(1, new_col_name, df.pop(new_col_name))
 
-    df = df.drop(columns=["Id"])
+        df = df.drop(columns=["Id"])
 
     return df

sempy_labs/admin/_items.py

@@ -14,8 +14,10 @@ from sempy_labs._helper_functions import (
     _base_api,
     _create_dataframe,
 )
+from sempy._utils._log import log
 
 
+@log
 def _resolve_item_id(
     item: str,
     type: Optional[str] = None,
@@ -39,6 +41,7 @@ def _resolve_item_id(
     return item_id
 
 
+@log
 def _resolve_item_name_and_id(
     item: str,
     type: Optional[str] = None,
@@ -70,6 +73,7 @@ def _resolve_item_name_and_id(
     return item_name, item_id
 
 
+@log
 def list_items(
     capacity: Optional[str | UUID] = None,
     workspace: Optional[str | UUID] = None,
@@ -146,6 +150,7 @@ def list_items(
 
     responses = _base_api(request=url, client="fabric_sp", uses_pagination=True)
 
+    dfs = []
     for r in responses:
         for v in r.get("itemEntities", []):
             new_data = {
@@ -166,7 +171,10 @@ def list_items(
                 "Workspace Id": v.get("workspaceId"),
                 "Capacity Id": v.get("capacityId"),
             }
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     if item is not None:
         if _is_valid_uuid(item):
@@ -177,6 +185,7 @@ def list_items(
     return df
 
 
+@log
 def list_item_access_details(
     item: str | UUID = None,
     type: str = None,
@@ -241,6 +250,7 @@ def list_item_access_details(
         client="fabric_sp",
     )
 
+    dfs = []
     for v in response.json().get("accessDetails", []):
         new_data = {
             "User Id": v.get("principal", {}).get("id"),
@@ -257,6 +267,9 @@ def list_item_access_details(
             "Item Name": item_name,
             "Item Id": item_id,
         }
-        df = pd.concat([df, pd.DataFrame([new_data])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     return df

sempy_labs/admin/_reports.py

@@ -8,8 +8,10 @@ from sempy_labs._helper_functions import (
 )
 from uuid import UUID
 import sempy_labs._icons as icons
+from sempy._utils._log import log
 
 
+@log
 def list_reports(
     top: Optional[int] = None,
     skip: Optional[int] = None,
@@ -67,37 +69,36 @@ def list_reports(
 
     url.rstrip("$").rstrip("?")
     response = _base_api(request=url, client="fabric_sp")
-    rows = []
 
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "Report Id": v.get("id"),
-                "Report Name": v.get("name"),
-                "Type": v.get("reportType"),
-                "Web URL": v.get("webUrl"),
-                "Embed URL": v.get("embedUrl"),
-                "Dataset Id": v.get("datasetId"),
-                "Created Date": v.get("createdDateTime"),
-                "Modified Date": v.get("modifiedDateTime"),
-                "Created By": v.get("createdBy"),
-                "Modified By": v.get("modifiedBy"),
-                "Sensitivity Label Id": v.get("sensitivityLabel", {}).get("labelId"),
-                "Users": v.get("users"),
-                "Subscriptions": v.get("subscriptions"),
-                "Workspace Id": v.get("workspaceId"),
-                "Report Flags": v.get("reportFlags"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "Report Id": v.get("id"),
+            "Report Name": v.get("name"),
+            "Type": v.get("reportType"),
+            "Web URL": v.get("webUrl"),
+            "Embed URL": v.get("embedUrl"),
+            "Dataset Id": v.get("datasetId"),
+            "Created Date": v.get("createdDateTime"),
+            "Modified Date": v.get("modifiedDateTime"),
+            "Created By": v.get("createdBy"),
+            "Modified By": v.get("modifiedBy"),
+            "Sensitivity Label Id": v.get("sensitivityLabel", {}).get("labelId"),
+            "Users": v.get("users"),
+            "Subscriptions": v.get("subscriptions"),
+            "Workspace Id": v.get("workspaceId"),
+            "Report Flags": v.get("reportFlags"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def _resolve_report_id(report: str | UUID) -> str:
     if _is_valid_uuid(report):
         return report
@@ -109,6 +110,7 @@ def _resolve_report_id(report: str | UUID) -> str:
         return df_filt["Report Id"].iloc[0]
 
 
+@log
 def list_report_users(report: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified report.
@@ -144,27 +146,26 @@ def list_report_users(report: str | UUID) -> pd.DataFrame:
     url = f"/v1.0/myorg/admin/reports/{report_id}/users"
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "Report User Access Right": v.get("reportUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "Report User Access Right": v.get("reportUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df
 
 
+@log
 def list_report_subscriptions(report: str | UUID) -> pd.DataFrame:
     """
     Shows a list of report subscriptions along with subscriber details. This is a preview API call.
@@ -210,30 +211,28 @@ def list_report_subscriptions(report: str | UUID) -> pd.DataFrame:
         client="fabric_sp",
     )
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "Subscription Id": v.get("id"),
-                "Title": v.get("title"),
-                "Artifact Id": v.get("artifactId"),
-                "Artifact Name": v.get("artifactDisplayName"),
-                "Sub Artifact Name": v.get("subArtifactDisplayName"),
-                "Artifact Type": v.get("artifactType"),
-                "Is Enabled": v.get("isEnabled"),
-                "Frequency": v.get("frequency"),
-                "Start Date": v.get("startDate"),
-                "End Date": v.get("endDate"),
-                "Link To Content": v.get("linkToContent"),
-                "Preview Image": v.get("previewImage"),
-                "Attachment Format": v.get("attachmentFormat"),
-                "Users": str(v.get("users")),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "Subscription Id": v.get("id"),
+            "Title": v.get("title"),
+            "Artifact Id": v.get("artifactId"),
+            "Artifact Name": v.get("artifactDisplayName"),
+            "Sub Artifact Name": v.get("subArtifactDisplayName"),
+            "Artifact Type": v.get("artifactType"),
+            "Is Enabled": v.get("isEnabled"),
+            "Frequency": v.get("frequency"),
+            "Start Date": v.get("startDate"),
+            "End Date": v.get("endDate"),
+            "Link To Content": v.get("linkToContent"),
+            "Preview Image": v.get("previewImage"),
+            "Attachment Format": v.get("attachmentFormat"),
+            "Users": str(v.get("users")),
+        }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df

sempy_labs/admin/_shared.py

@@ -3,8 +3,10 @@ from sempy_labs._helper_functions import (
     _base_api,
     _create_dataframe,
 )
+from sempy._utils._log import log
 
 
+@log
 def list_widely_shared_artifacts(
     api_name: str = "LinksSharedToWholeOrganization",
 ) -> pd.DataFrame:
@@ -55,6 +57,7 @@ def list_widely_shared_artifacts(
         uses_pagination=True,
     )
 
+    dfs = []
     for r in responses:
         for v in r.get("ArtifactAccessEntities", []):
             sharer = v.get("sharer", {})
@@ -71,6 +74,9 @@ def list_widely_shared_artifacts(
                 "Sharer Principal Type": sharer.get("principalType"),
             }
 
-            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+            dfs.append(pd.DataFrame(new_data, index=[0]))
+
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
 
     return df

sempy_labs/admin/_tags.py

@@ -6,8 +6,10 @@ from uuid import UUID
 from sempy_labs._tags import list_tags
 import sempy_labs._icons as icons
 from typing import List
+from sempy._utils._log import log
 
 
+@log
 def resolve_tag_id(tag: str | UUID):
 
     if _is_valid_uuid(tag):
@@ -22,6 +24,7 @@ def resolve_tag_id(tag: str | UUID):
     return tag_id
 
 
+@log
 def create_tags(tags: str | List[str]):
     """
     Creates a new tag or tags.
@@ -77,6 +80,7 @@ def create_tags(tags: str | List[str]):
     print(f"{icons.green_dot} The '{available_tags}' tag(s) have been created.")
 
 
+@log
 def delete_tag(tag: str | UUID):
     """
     Deletes a tag.
@@ -98,6 +102,7 @@ def delete_tag(tag: str | UUID):
     print(f"{icons.green_dot} The '{tag}' tag has been deleted.")
 
 
+@log
 def update_tag(name: str, tag: str | UUID):
     """
     Updates the name of a tag.

sempy_labs/admin/_tenant.py

@@ -38,6 +38,7 @@ def list_tenant_settings() -> pd.DataFrame:
 
     response = _base_api(request="/v1/admin/tenantsettings", client="fabric_sp")
 
+    dfs = []
     for i in response.json().get("value", []):
         new_data = {
             "Setting Name": i.get("settingName"),
@@ -47,9 +48,11 @@ def list_tenant_settings() -> pd.DataFrame:
             "Tenant Setting Group": i.get("tenantSettingGroup"),
             "Enabled Security Groups": [i.get("enabledSecurityGroups", [])],
         }
-        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
+        _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df