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

sempy_labs/_tags.py

@@ -10,8 +10,10 @@ import pandas as pd
 from typing import Optional, List
 from uuid import UUID
 import sempy_labs._icons as icons
+from sempy._utils._log import log
 
 
+@log
 def list_tags() -> pd.DataFrame:
     """
     Shows a list of all the tenant's tags.
@@ -39,7 +41,6 @@ def list_tags() -> pd.DataFrame:
     )
 
     dfs = []
-
     for r in responses:
         for v in r.get("value", []):
             new_data = {
@@ -55,6 +56,7 @@ def list_tags() -> pd.DataFrame:
     return df
 
 
+@log
 def resolve_tags(tags: str | List[str]) -> List[str]:
     """
     Resolves the tags to a list of strings.
@@ -92,6 +94,7 @@ def resolve_tags(tags: str | List[str]) -> List[str]:
     return tag_list
 
 
+@log
 def apply_tags(
     item: str | UUID,
     type: str,
@@ -143,6 +146,7 @@ def apply_tags(
     )
 
 
+@log
 def unapply_tags(
     item: str | UUID,
     type: str,

sempy_labs/_user_delegation_key.py

@@ -4,8 +4,10 @@ from sempy_labs._helper_functions import (
 )
 from datetime import datetime, timedelta, timezone
 import xml.etree.ElementTree as ET
+from sempy._utils._log import log
 
 
+@log
 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.

sempy_labs/_variable_libraries.py

@@ -1,5 +1,4 @@
 from sempy_labs._helper_functions import (
-    resolve_workspace_name_and_id,
     resolve_workspace_id,
     _base_api,
     _create_dataframe,
@@ -9,8 +8,10 @@ from sempy_labs._helper_functions import (
 import pandas as pd
 from typing import Optional
 from uuid import UUID
+from sempy._utils._log import log
 
 
+@log
 def list_variable_libraries(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Shows the variable libraries within a workspace.
@@ -68,6 +69,7 @@ def list_variable_libraries(workspace: Optional[str | UUID] = None) -> pd.DataFr
     return df
 
 
+@log
 def delete_variable_library(
     variable_library: str | UUID, workspace: Optional[str | UUID] = None
 ):

sempy_labs/_warehouses.py

@@ -4,13 +4,16 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
     _update_dataframe_datatypes,
     delete_item,
+    resolve_workspace_id,
 )
 import pandas as pd
 from typing import Optional
 import sempy_labs._icons as icons
 from uuid import UUID
+from sempy._utils._log import log
 
 
+@log
 def create_warehouse(
     warehouse: str,
     description: Optional[str] = None,
@@ -68,6 +71,7 @@ def create_warehouse(
     return result.get("id")
 
 
+@log
 def list_warehouses(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Shows the warehouses within a workspace.
@@ -99,7 +103,7 @@ def list_warehouses(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     }
     df = _create_dataframe(columns=columns)
 
-    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+    workspace_id = resolve_workspace_id(workspace)
 
     responses = _base_api(
         request=f"/v1/workspaces/{workspace_id}/warehouses",
@@ -107,6 +111,7 @@ def list_warehouses(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
         client="fabric_sp",
     )
 
+    dfs = []
     for r in responses:
         for v in r.get("value", []):
             prop = v.get("properties", {})
@@ -119,13 +124,16 @@ def list_warehouses(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
                 "Created Date": prop.get("createdDate"),
                 "Last Updated Time": prop.get("lastUpdatedTime"),
             }
-            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 delete_warehouse(name: str | UUID, workspace: Optional[str | UUID] = None):
     """
     Deletes a Fabric warehouse.
@@ -145,6 +153,7 @@ def delete_warehouse(name: str | UUID, workspace: Optional[str | UUID] = None):
     delete_item(item=name, type="Warehouse", workspace=workspace)
 
 
+@log
 def get_warehouse_tables(
     warehouse: str | UUID, workspace: Optional[str | UUID] = None
 ) -> pd.DataFrame:
@@ -180,6 +189,7 @@ def get_warehouse_tables(
     return df
 
 
+@log
 def get_warehouse_columns(
     warehouse: str | UUID, workspace: Optional[str | UUID] = None
 ) -> pd.DataFrame:

sempy_labs/_workloads.py

@@ -7,8 +7,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
 )
 from uuid import UUID
+from sempy._utils._log import log
 
 
+@log
 def list_workloads(capacity: str | UUID, **kwargs) -> pd.DataFrame:
     """
     Returns the current state of the specified capacity workloads.
@@ -59,6 +61,7 @@ def list_workloads(capacity: str | UUID, **kwargs) -> pd.DataFrame:
     return df
 
 
+@log
 def patch_workload(
     capacity: str | UUID,
     workload_name: str,

sempy_labs/_workspace_identity.py

@@ -5,8 +5,10 @@ from sempy_labs._helper_functions import (
 from typing import Optional
 import sempy_labs._icons as icons
 from uuid import UUID
+from sempy._utils._log import log
 
 
+@log
 def provision_workspace_identity(workspace: Optional[str | UUID] = None):
     """
     Provisions a workspace identity for a workspace.
@@ -38,6 +40,7 @@ def provision_workspace_identity(workspace: Optional[str | UUID] = None):
     )
 
 
+@log
 def deprovision_workspace_identity(workspace: Optional[str | UUID] = None):
     """
     Deprovisions a workspace identity for a workspace.

sempy_labs/_workspaces.py

@@ -8,8 +8,10 @@ from sempy_labs._helper_functions import (
     _create_dataframe,
 )
 from uuid import UUID
+from sempy._utils._log import log
 
 
+@log
 def delete_user_from_workspace(
     email_address: str, workspace: Optional[str | UUID] = None
 ):
@@ -42,6 +44,7 @@ def delete_user_from_workspace(
     )
 
 
+@log
 def update_workspace_user(
     email_address: str,
     role_name: str,
@@ -102,6 +105,7 @@ def update_workspace_user(
     )
 
 
+@log
 def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     A list of all the users of a workspace and their roles.
@@ -140,6 +144,7 @@ def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame
         client="fabric_sp",
     )
 
+    dfs = []
     for r in responses:
         for v in r.get("value", []):
             p = v.get("principal", {})
@@ -150,11 +155,15 @@ def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame
                 "Role": v.get("role"),
                 "Email Address": p.get("userDetails", {}).get("userPrincipalName"),
             }
-            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 add_user_to_workspace(
     email_address: str,
     role_name: str,
@@ -213,6 +222,7 @@ def add_user_to_workspace(
     )
 
 
+@log
 def assign_workspace_to_capacity(
     capacity: str | UUID,
     workspace: Optional[str | UUID] = None,
@@ -255,6 +265,7 @@ def assign_workspace_to_capacity(
     )
 
 
+@log
 def unassign_workspace_from_capacity(workspace: Optional[str | UUID] = None):
     """
     Unassigns a workspace from its assigned capacity.
@@ -284,6 +295,7 @@ def unassign_workspace_from_capacity(workspace: Optional[str | UUID] = None):
     )
 
 
+@log
 def list_workspace_role_assignments(
     workspace: Optional[str | UUID] = None,
 ) -> pd.DataFrame:
@@ -337,6 +349,7 @@ def list_workspace_role_assignments(
     return df
 
 
+@log
 def delete_workspace(workspace: Optional[str | UUID] = None):
     """
     Deletes a workspace.

sempy_labs/admin/__init__.py

@@ -6,6 +6,7 @@ from sempy_labs.admin._workspaces import (
     add_user_to_workspace,
     delete_user_from_workspace,
     restore_deleted_workspace,
+    list_orphaned_workspaces,
 )
 from sempy_labs.admin._artifacts import (
     list_unused_artifacts,
@@ -139,6 +140,7 @@ __all__ = [
     "add_user_to_workspace",
     "delete_user_from_workspace",
     "restore_deleted_workspace",
+    "list_orphaned_workspaces",
     "list_capacity_users",
     "list_user_subscriptions",
     "list_report_subscriptions",

sempy_labs/admin/_activities.py

@@ -107,6 +107,8 @@ def list_activity_events(
 
     responses = _base_api(request=url, client="fabric_sp", uses_pagination=True)
 
+    dfs = []
+
     for r in responses:
         if return_dataframe:
             for i in r.get("activityEventEntities", []):
@@ -150,17 +152,16 @@ def list_activity_events(
                     "Consumption Method": i.get("ConsumptionMethod"),
                     "Artifact Kind": i.get("ArtifactKind"),
                 }
-                df = pd.concat(
-                    [df, pd.DataFrame(new_data, index=[0])],
-                    ignore_index=True,
-                )
+                dfs.append(pd.DataFrame(new_data, index=[0]))
         else:
             response_json["activityEventEntities"].extend(
                 r.get("activityEventEntities")
             )
 
     if return_dataframe:
-        _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
     else:
         return response_json

sempy_labs/admin/_apps.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_apps(
     top: Optional[int] = 1000,
     skip: Optional[int] = None,
@@ -56,26 +58,25 @@ def list_apps(
     url = _build_url(url, params)
     response = _base_api(request=url, client="fabric_sp")
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "App Name": v.get("name"),
-                "App Id": v.get("id"),
-                "Description": v.get("description"),
-                "Published By": v.get("publishedBy"),
-                "Last Update": v.get("lastUpdate"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
-
-    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+        new_data = {
+            "App Name": v.get("name"),
+            "App Id": v.get("id"),
+            "Description": v.get("description"),
+            "Published By": v.get("publishedBy"),
+            "Last Update": v.get("lastUpdate"),
+        }
+        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_app_id(app: str | UUID) -> str:
     if _is_valid_uuid(app):
         return app
@@ -87,6 +88,7 @@ def _resolve_app_id(app: str | UUID) -> str:
         return df_filt["App Id"].iloc[0]
 
 
+@log
 def list_app_users(app: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified app.
@@ -122,22 +124,20 @@ def list_app_users(app: str | UUID) -> pd.DataFrame:
     url = f"/v1.0/myorg/admin/apps/{app_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"),
-                "App User Access Right": v.get("appUserAccessRight"),
-                "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"),
+            "App User Access Right": v.get("appUserAccessRight"),
+            "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/_artifacts.py

@@ -9,8 +9,10 @@ from sempy_labs.admin._basic_functions import (
     _create_dataframe,
     _update_dataframe_datatypes,
 )
+from sempy._utils._log import log
 
 
+@log
 def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Returns a list of datasets, reports, and dashboards that have not been used within 30 days for the specified workspace.
@@ -25,7 +27,7 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
         A pandas dataframe showing a list of datasets, reports, and dashboards that have not been used within 30 days for the specified workspace.
     """
 
-    (workspace_name, workspace_id) = _resolve_workspace_name_and_id(workspace)
+    (_, workspace_id) = _resolve_workspace_name_and_id(workspace)
 
     columns = {
         "Artifact Name": "string",
@@ -44,6 +46,7 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
         uses_pagination=True,
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("unusedArtifactEntities", []):
             new_data = {
@@ -55,8 +58,10 @@ def list_unused_artifacts(workspace: Optional[str | UUID] = None) -> pd.DataFram
                 "Last Accessed Date Time": i.get("lastAccessedDateTime"),
             }
 
-            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

sempy_labs/admin/_basic_functions.py

@@ -249,6 +249,7 @@ def unassign_workspaces_from_capacity(
     )
 
 
+@log
 def list_modified_workspaces(
     modified_since: Optional[str] = None,
     exclude_inactive_workspaces: Optional[bool] = False,
@@ -298,6 +299,7 @@ def list_modified_workspaces(
     return df
 
 
+@log
 def list_workspace_access_details(
     workspace: Optional[Union[str, UUID]] = None,
 ) -> pd.DataFrame:
@@ -350,6 +352,7 @@ def list_workspace_access_details(
     return df
 
 
+@log
 def _resolve_workspace_name(workspace_id: Optional[UUID] = None) -> str:
     from sempy_labs._helper_functions import _get_fabric_context_setting
     from sempy.fabric.exceptions import FabricHTTPException
@@ -372,6 +375,7 @@ def _resolve_workspace_name(workspace_id: Optional[UUID] = None) -> str:
     return workspace_name
 
 
+@log
 def _resolve_workspace_name_and_id(
     workspace: str | UUID,
 ) -> Tuple[str, UUID]:
@@ -397,6 +401,7 @@ def _resolve_workspace_name_and_id(
     return workspace_name, workspace_id
 
 
+@log
 def list_workspace_users(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified workspace.

sempy_labs/admin/_capacities.py

@@ -13,6 +13,7 @@ from sempy_labs._helper_functions import (
 )
 
 
+@log
 def patch_capacity(capacity: str | UUID, tenant_key_id: UUID):
     """
     Changes specific capacity information. Currently, this API call only supports changing the capacity's encryption key.
@@ -44,6 +45,7 @@ def patch_capacity(capacity: str | UUID, tenant_key_id: UUID):
     )
 
 
+@log
 def _resolve_capacity_name_and_id(
     capacity: str | UUID,
 ) -> Tuple[str, UUID]:
@@ -58,6 +60,7 @@ def _resolve_capacity_name_and_id(
     return capacity_name, capacity_id
 
 
+@log
 def _resolve_capacity_id(
     capacity: str | UUID,
 ) -> UUID:
@@ -76,6 +79,7 @@ def _resolve_capacity_id(
     return capacity_id
 
 
+@log
 def _list_capacities_meta() -> pd.DataFrame:
     """
     Shows the a list of capacities and their properties. This function is the admin version.
@@ -102,6 +106,7 @@ def _list_capacities_meta() -> pd.DataFrame:
         request="/v1.0/myorg/admin/capacities", client="fabric_sp", uses_pagination=True
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("value", []):
             new_data = {
@@ -112,11 +117,15 @@ def _list_capacities_meta() -> pd.DataFrame:
                 "State": i.get("state"),
                 "Admins": [i.get("admins", [])],
             }
-            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 get_capacity_assignment_status(
     workspace: Optional[str | UUID] = None,
 ) -> pd.DataFrame:
@@ -178,6 +187,7 @@ def get_capacity_assignment_status(
     return df
 
 
+@log
 def get_capacity_state(capacity: Optional[str | UUID] = None):
     """
     Gets the state of a capacity.
@@ -248,6 +258,7 @@ def list_capacities(
         request="/v1.0/myorg/admin/capacities", client="fabric_sp", uses_pagination=True
     )
 
+    dfs = []
     for r in responses:
         for i in r.get("value", []):
             new_data = {
@@ -258,7 +269,10 @@ def list_capacities(
                 "State": i.get("state"),
                 "Admins": [i.get("admins", [])],
             }
-            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 capacity is not None:
         if _is_valid_uuid(capacity):
@@ -269,6 +283,7 @@ def list_capacities(
     return df
 
 
+@log
 def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
     """
     Shows a list of users that have access to the specified workspace.
@@ -288,7 +303,7 @@ def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
         A pandas dataframe showing a list of users that have access to the specified workspace.
     """
 
-    (capacity_name, capacity_id) = _resolve_capacity_name_and_id(capacity)
+    (_, capacity_id) = _resolve_capacity_name_and_id(capacity)
 
     columns = {
         "User Name": "string",
@@ -307,25 +322,23 @@ def list_capacity_users(capacity: str | UUID) -> pd.DataFrame:
         request=f"/v1.0/myorg/admin/capacities/{capacity_id}/users", client="fabric_sp"
     )
 
-    rows = []
+    dfs = []
     for v in response.json().get("value", []):
-        rows.append(
-            {
-                "User Name": v.get("displayName"),
-                "Email Address": v.get("emailAddress"),
-                "Capacity User Access Right": v.get("capacityUserAccessRight"),
-                "Identifier": v.get("identifier"),
-                "Graph Id": v.get("graphId"),
-                "Principal Type": v.get("principalType"),
-                "User Type": v.get("userType"),
-                "Profile": v.get("profile"),
-            }
-        )
-
-    if rows:
-        df = pd.DataFrame(rows, columns=list(columns.keys()))
+        new_data = {
+            "User Name": v.get("displayName"),
+            "Email Address": v.get("emailAddress"),
+            "Capacity User Access Right": v.get("capacityUserAccessRight"),
+            "Identifier": v.get("identifier"),
+            "Graph Id": v.get("graphId"),
+            "Principal Type": v.get("principalType"),
+            "User Type": v.get("userType"),
+            "Profile": v.get("profile"),
+        }
+        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
 
@@ -419,11 +432,10 @@ def get_refreshables(
 
     url = _build_url(url, params)
 
-    responses = _base_api(request=url, client="fabric_sp")
+    response = _base_api(request=url, client="fabric_sp")
 
-    refreshables = []
-
-    for i in responses.json().get("value", []):
+    dfs = []
+    for i in response.json().get("value", []):
         last_refresh = i.get("lastRefresh", {})
         refresh_schedule = i.get("refreshSchedule", {})
         new_data = {
@@ -461,11 +473,10 @@ def get_refreshables(
             "Refresh Schedule Notify Option": refresh_schedule.get("notifyOption"),
             "Configured By": i.get("configuredBy"),
         }
+        dfs.append(pd.DataFrame(new_data, index=[0]))
 
-        refreshables.append(new_data)
-
-    if len(refreshables) > 0:
-        df = pd.DataFrame(refreshables)
+    if dfs:
+        df = pd.concat(dfs, ignore_index=True)
         _update_dataframe_datatypes(dataframe=df, column_map=columns)
 
     return df