semantic-link-labs 0.9.3__py3-none-any.whl → 0.9.4__py3-none-any.whl

sempy_labs/admin/_shared.py

@@ -0,0 +1,74 @@
+import pandas as pd
+from sempy_labs._helper_functions import (
+    _base_api,
+    _create_dataframe,
+)
+
+
+def list_widely_shared_artifacts(
+    api_name: str = "LinksSharedToWholeOrganization",
+) -> pd.DataFrame:
+    """
+    Returns a list of Power BI reports that are shared with the whole organization through links or a list of Power BI items (such as reports or dashboards) that are published to the web.
+
+    This is a wrapper function for the following APIs:
+    `Admin - WidelySharedArtifacts LinksSharedToWholeOrganization <https://learn.microsoft.com/rest/api/power-bi/admin/widely-shared-artifacts-links-shared-to-whole-organization>`_.
+    `Admin - WidelySharedArtifacts PublishedToWeb <https://learn.microsoft.com/rest/api/power-bi/admin/widely-shared-artifacts-published-to-web>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    api_name : str, default = "LinksSharedToWholeOrganization"
+        The name of the API to call. Either "LinksSharedToWholeOrganization" or "PublishedToWeb".
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of Power BI reports that are shared with the whole organization through links or a list of Power BI items (such as reports or dashboards) that are published to the web.
+    """
+
+    columns = {
+        "Artifact Id": "string",
+        "Artifact Name": "string",
+        "Artifact Type": "string",
+        "Access Right": "string",
+        "Share Type": "string",
+        "Sharer Name": "string",
+        "Sharer Email Address": "string",
+        "Sharer Identifier": "string",
+        "Sharer Graph Id": "string",
+        "Sharer Principal Type": "string",
+    }
+
+    df = _create_dataframe(columns=columns)
+
+    api = (
+        "linksSharedToWholeOrganization"
+        if api_name == "LinksSharedToWholeOrganization"
+        else "publishedToWeb"
+    )
+
+    responses = _base_api(
+        request=f"/v1.0/myorg/admin/widelySharedArtifacts/{api}", client="fabric_sp"
+    )
+
+    for r in responses:
+        for v in r.get("value", []):
+            sharer = v.get("sharer", {})
+            new_data = {
+                "Artifact Id": v.get("artifactId"),
+                "Artifact Name": v.get("displayName"),
+                "Artifact Type": v.get("artifactType"),
+                "Access Right": v.get("accessRight"),
+                "Share Type": v.get("shareType"),
+                "Sharer Name": sharer.get("displayName"),
+                "Sharer Email Address": sharer.get("emailAddress"),
+                "Sharer Identifier": sharer.get("identifier"),
+                "Sharer Graph Id": sharer.get("graphId"),
+                "Sharer Principal Type": sharer.get("principalType"),
+            }
+
+            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    return df

sempy_labs/admin/_tenant.py

@@ -0,0 +1,489 @@
+from sempy_labs._helper_functions import (
+    _update_dataframe_datatypes,
+    _base_api,
+    _create_dataframe,
+)
+from sempy._utils._log import log
+import pandas as pd
+from uuid import UUID
+from sempy_labs.admin._capacities import _resolve_capacity_name_and_id
+import sempy_labs._icons as icons
+from typing import Optional, List
+
+
+@log
+def list_tenant_settings() -> pd.DataFrame:
+    """
+    Lists all tenant settings.
+
+    This is a wrapper function for the following API: `Tenants - List Tenant Settings <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-tenant-settings>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the tenant settings.
+    """
+
+    columns = {
+        "Setting Name": "string",
+        "Title": "string",
+        "Enabled": "bool",
+        "Can Specify Security Groups": "bool",
+        "Tenant Setting Group": "string",
+        "Enabled Security Groups": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    response = _base_api(request="/v1/admin/tenantsettings", client="fabric_sp")
+
+    for i in response.json().get("value", []):
+        new_data = {
+            "Setting Name": i.get("settingName"),
+            "Title": i.get("title"),
+            "Enabled": i.get("enabled"),
+            "Can Specify Security Groups": i.get("canSpecifySecurityGroups"),
+            "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)
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df
+
+
+@log
+def list_capacity_tenant_settings_overrides(
+    capacity: Optional[str | UUID] = None,
+    return_dataframe: bool = True,
+) -> pd.DataFrame | dict:
+    """
+    Returns list of tenant setting overrides that override at the capacities.
+
+    This is a wrapper function for the following API: `Tenants - List Capacities Tenant Settings Overrides <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-capacities-tenant-settings-overrides>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    capacity : str | uuid.UUID, default=None
+        The capacity name or ID.
+        Defaults to None which resolves to showing all capacities.
+    return_dataframe : bool, default=True
+        If True, returns a dataframe. If False, returns a dictionary.
+
+    Returns
+    -------
+    pandas.DataFrame | dict
+        A pandas dataframe showing a list of tenant setting overrides that override at the capacities.
+    """
+
+    columns = {
+        "Capacity Id": "string",
+        "Setting Name": "string",
+        "Setting Title": "string",
+        "Setting Enabled": "bool",
+        "Can Specify Security Groups": "bool",
+        "Enabled Security Groups": "string",
+        "Tenant Setting Group": "string",
+        "Tenant Setting Properties": "string",
+        "Delegate to Workspace": "bool",
+        "Delegated From": "string",
+    }
+
+    if capacity is None:
+        url = "/v1/admin/capacities/delegatedTenantSettingOverrides"
+    else:
+        (_, capacity_id) = _resolve_capacity_name_and_id(capacity=capacity)
+        url = f"/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides"
+    responses = _base_api(
+        request=url,
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    def create_new_data(setting, capacity_id=None):
+        return {
+            "Capacity Id": capacity_id or setting.get("id"),
+            "Setting Name": setting.get("settingName"),
+            "Setting Title": setting.get("title"),
+            "Setting Enabled": setting.get("enabled"),
+            "Can Specify Security Groups": setting.get("canSpecifySecurityGroups"),
+            "Enabled Security Groups": setting.get("enabledSecurityGroups", []),
+            "Tenant Setting Group": setting.get("tenantSettingGroup"),
+            "Tenant Setting Properties": setting.get("properties", []),
+            "Delegate to Workspace": setting.get("delegateToWorkspace"),
+            "Delegated From": setting.get("delegatedFrom"),
+        }
+
+    def process_responses(responses, capacity_id=None, return_dataframe=False):
+        data = []
+        df = _create_dataframe(columns=columns)
+
+        for r in responses:
+            if capacity_id is None:
+                # If capacity_id is None, we access 'Overrides' -> 'tenantSettings'
+                for override in r.get("overrides", []):
+                    tenant_settings = override.get("tenantSettings", [])
+                    for setting in tenant_settings:
+                        data.append(
+                            create_new_data(setting)
+                        )  # No capacity_id needed here
+            else:
+                # If capacity_id is provided, we access 'value' directly for tenantSettings
+                for setting in r.get("value", []):
+                    data.append(
+                        create_new_data(setting, capacity_id)
+                    )  # Use provided capacity_id
+
+        if return_dataframe:
+            if data:
+                df = pd.DataFrame(data)
+                _update_dataframe_datatypes(dataframe=df, column_map=columns)
+            return df
+        else:
+            key = "overrides" if capacity_id is None else "value"
+            continuation_uri = r.get("continuationUri", "")
+            continuation_token = r.get("continuationToken", "")
+
+            return {
+                key: data,
+                "continuationUri": continuation_uri,
+                "continuationToken": continuation_token,
+            }
+
+    # Main logic
+    if capacity is None:
+        return (
+            process_responses(responses, return_dataframe=True)
+            if return_dataframe
+            else process_responses(responses)
+        )
+    else:
+        return (
+            process_responses(responses, capacity_id=capacity_id, return_dataframe=True)
+            if return_dataframe
+            else process_responses(responses, capacity_id=capacity_id)
+        )
+
+
+@log
+def list_capacities_delegated_tenant_settings(
+    return_dataframe: bool = True,
+) -> pd.DataFrame | dict:
+    """
+    Returns list of tenant setting overrides that override at the capacities.
+
+    NOTE: This function is to be deprecated. Please use the `list_capacity_tenant_settings_overrides` function instead.
+
+    This is a wrapper function for the following API: `Tenants - List Capacities Tenant Settings Overrides <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-capacities-tenant-settings-overrides>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    return_dataframe : bool, default=True
+        If True, returns a dataframe. If False, returns a dictionary.
+
+    Returns
+    -------
+    pandas.DataFrame | dict
+        A pandas dataframe showing a list of tenant setting overrides that override at the capacities.
+    """
+
+    list_capacity_tenant_settings_overrides(return_dataframe=return_dataframe)
+
+
+@log
+def delete_capacity_tenant_setting_override(capacity: str | UUID, tenant_setting: str):
+    """
+    Remove given tenant setting override for given capacity Id.
+
+    This is a wrapper function for the following API: `Tenants - Delete Capacity Tenant Setting Override <https://learn.microsoft.com/rest/api/fabric/admin/tenants/delete-capacity-tenant-setting-override>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    capacity : str | uuid.UUID
+        The capacity name or ID.
+    tenant_setting : str
+        The tenant setting name. Example: "TenantSettingForCapacityDelegatedSwitch"
+    """
+
+    (capacity_name, capacity_id) = _resolve_capacity_name_and_id(capacity=capacity)
+
+    _base_api(
+        request=f"/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides/{tenant_setting}",
+        client="fabric_sp",
+        method="delete",
+    )
+
+    print(
+        f"{icons.green_dot} The '{tenant_setting}' tenant setting has been removed from the '{capacity_name}' capacity."
+    )
+
+
+@log
+def update_tenant_setting(
+    tenant_setting: str,
+    enabled: bool,
+    delegate_to_capacity: Optional[bool] = None,
+    delegate_to_domain: Optional[bool] = None,
+    delegate_to_workspace: Optional[bool] = None,
+    enabled_security_groups: Optional[List[dict]] = None,
+    excluded_security_groups: Optional[List[dict]] = None,
+    properties: Optional[List[dict]] = None,
+):
+    """
+    Update a given tenant setting.
+
+    This is a wrapper function for the following API: `Tenants - Update Tenant Setting <https://learn.microsoft.com/rest/api/fabric/admin/tenants/update-tenant-setting>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    tenant_setting : str
+        The tenant setting name. Example: "TenantSettingForCapacityDelegatedSwitch"
+    enabled : bool
+        The status of the tenant setting. False - Disabled, True - Enabled.
+    delegate_to_capacity : bool, default=None
+        Indicates whether the tenant setting can be delegated to a capacity admin. False - Capacity admin cannot override the tenant setting. True - Capacity admin can override the tenant setting.
+    delegate_to_domain : bool, default=None
+        Indicates whether the tenant setting can be delegated to a domain admin. False - Domain admin cannot override the tenant setting. True - Domain admin can override the tenant setting.
+    delegate_to_workspace : bool, default=None
+        Indicates whether the tenant setting can be delegated to a workspace admin. False - Workspace admin cannot override the tenant setting. True - Workspace admin can override the tenant setting.
+    enabled_security_groups : List[dict], default=None
+        A list of enabled security groups. Example:
+        [
+            {
+            "graphId": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
+            "name": "TestComputeCdsa"
+            }
+        ]
+    excluded_security_groups : List[dict], default=None
+        A list of excluded security groups. Example:
+        [
+            {
+            "graphId": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
+            "name": "TestComputeCdsa"
+            }
+        ]
+    properties : List[dict], default=None
+        Tenant setting properties. Example:
+        [
+            {
+            "name": "CreateP2w",
+            "value": "true",
+            "type": "Boolean"
+            }
+        ]
+    """
+
+    payload = {"enabled": enabled}
+
+    if delegate_to_capacity is not None:
+        payload["delegateToCapacity"] = delegate_to_capacity
+    if delegate_to_domain is not None:
+        payload["delegateToDomain"] = delegate_to_domain
+    if delegate_to_workspace is not None:
+        payload["delegateToWorkspace"] = delegate_to_workspace
+    if enabled_security_groups is not None:
+        payload["enabledSecurityGroups"] = enabled_security_groups
+    if excluded_security_groups is not None:
+        payload["excludedSecurityGroups"] = excluded_security_groups
+    if properties is not None:
+        payload["properties"] = properties
+
+    _base_api(
+        request=f"/v1/admin/tenantsettings/{tenant_setting}/update",
+        client="fabric_sp",
+        method="post",
+        payload=payload,
+    )
+
+    print(f"{icons.green_dot} The '{tenant_setting}' tenant setting has been updated.")
+
+
+@log
+def update_capacity_tenant_setting_override(
+    capacity: str | UUID,
+    tenant_setting: str,
+    enabled: bool,
+    delegate_to_workspace: Optional[bool] = None,
+    enabled_security_groups: Optional[List[dict]] = None,
+    excluded_security_groups: Optional[List[dict]] = None,
+):
+    """
+    Update given tenant setting override for given capacity.
+
+    This is a wrapper function for the following API: `Tenants - Update Capacity Tenant Setting Override <https://learn.microsoft.com/en-us/rest/api/fabric/admin/tenants/update-capacity-tenant-setting-override>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Parameters
+    ----------
+    capacity : str | uuid.UUID
+        The capacity name or ID.
+    tenant_setting : str
+        The tenant setting name. Example: "TenantSettingForCapacityDelegatedSwitch"
+    enabled : bool
+        The status of the tenant setting. False - Disabled, True - Enabled.
+    delegate_to_workspace : bool, default=None
+        Indicates whether the tenant setting can be delegated to a workspace admin. False - Workspace admin cannot override the tenant setting. True - Workspace admin can override the tenant setting.
+    enabled_security_groups : List[dict], default=None
+        A list of enabled security groups. Example:
+        [
+            {
+            "graphId": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
+            "name": "TestComputeCdsa"
+            }
+        ]
+    excluded_security_groups : List[dict], default=None
+        A list of excluded security groups. Example:
+        [
+            {
+            "graphId": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
+            "name": "TestComputeCdsa"
+            }
+        ]
+    """
+
+    (capacity_name, capacity_id) = _resolve_capacity_name_and_id(capacity=capacity)
+
+    payload = {"enabled": enabled}
+
+    if delegate_to_workspace is not None:
+        payload["delegateToWorkspace"] = delegate_to_workspace
+    if enabled_security_groups is not None:
+        payload["enabledSecurityGroups"] = enabled_security_groups
+    if excluded_security_groups is not None:
+        payload["excludedSecurityGroups"] = excluded_security_groups
+
+    _base_api(
+        request=f"/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides/{tenant_setting}/update",
+        client="fabric_sp",
+        method="post",
+        payload=payload,
+    )
+
+    print(
+        f"{icons.green_dot} The '{tenant_setting}' tenant setting for the '{capacity_name}' capacity has been updated."
+    )
+
+
+@log
+def list_workspaces_tenant_settings_overrides() -> pd.DataFrame:
+    """
+    Shows a list of workspace delegation setting overrides. In order to run this function, you must enable the workspace's delegated OneLake settings. To do this, navigate to the workspace, Workspace Settings -> Delegated Settings -> OneLake settings -> Set to 'On'.
+
+    This is a wrapper function for the following API: `Tenants - List Workspaces Tenant Settings Overrides <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-workspaces-tenant-settings-overrides>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of workspace delegation setting overrides.
+    """
+
+    columns = {
+        "Setting Name": "string",
+        "Title": "string",
+        "Enabled": "bool",
+        "Can Specify Security Groups": "bool",
+        "Enabled Security Groups": "string",
+        "Tenant Setting Group": "string",
+        "Delegated From": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    responses = _base_api(
+        request="/v1/admin/workspaces/delegatedTenantSettingOverrides",
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    for r in responses:
+        for v in r.get("value", []):
+            for setting in v.get("tenantSettings", []):
+                new_data = {
+                    "Setting Name": setting.get("settingName"),
+                    "Title": setting.get("title"),
+                    "Enabled": setting.get("enabled"),
+                    "Can Specify Security Groups": setting.get(
+                        "canSpecifySecurityGroups"
+                    ),
+                    "Enabled Security Groups": [
+                        setting.get("enabledSecurityGroups", [])
+                    ],
+                    "Tenant Setting Group": setting.get("tenantSettingGroup"),
+                    "Delegated From": setting.get("delegatedFrom"),
+                }
+
+            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df
+
+
+@log
+def list_domain_tenant_settings_overrides() -> pd.DataFrame:
+    """
+    Shows a list of domain delegation setting overrides.
+
+    This is a wrapper function for the following API: `Tenants - List Domains Tenant Settings Overrides <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-domains-tenant-settings-overrides>`_.
+
+    Service Principal Authentication is supported (see `here <https://github.com/microsoft/semantic-link-labs/blob/main/notebooks/Service%20Principal.ipynb>`_ for examples).
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of domain delegation setting overrides.
+    """
+
+    columns = {
+        "Setting Name": "string",
+        "Title": "string",
+        "Enabled": "bool",
+        "Can Specify Security Groups": "bool",
+        "Enabled Security Groups": "string",
+        "Tenant Setting Group": "string",
+        "Delegated To Workspace": "bool",
+        "Delegated From": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    responses = _base_api(
+        request="/v1/admin/domains/delegatedTenantSettingOverrides",
+        client="fabric_sp",
+        uses_pagination=True,
+    )
+
+    for r in responses:
+        for v in r.get("value", []):
+            for setting in v.get("tenantSettings", []):
+                new_data = {
+                    "Setting Name": setting.get("settingName"),
+                    "Title": setting.get("title"),
+                    "Enabled": setting.get("enabled"),
+                    "Can Specify Security Groups": setting.get(
+                        "canSpecifySecurityGroups"
+                    ),
+                    "Enabled Security Groups": [
+                        setting.get("enabledSecurityGroups", [])
+                    ],
+                    "Tenant Setting Group": setting.get("tenantSettingGroup"),
+                    "Delegated To Workspace": setting.get("delegateToWorkspace"),
+                    "Delegated From": setting.get("delegatedFrom"),
+                }
+
+            df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df

sempy_labs/directlake/_dl_helper.py

@@ -11,7 +11,6 @@ from sempy_labs._helper_functions import (
     _convert_data_type,
     resolve_dataset_name_and_id,
     resolve_workspace_name_and_id,
-    _base_api,
 )
 
 

sempy_labs/directlake/_update_directlake_partition_entity.py

@@ -77,6 +77,12 @@ def update_direct_lake_partition_entity(
                 )
 
             tom.model.Tables[tName].Partitions[part_name].Source.EntityName = eName
+
+            # Update source lineage tag
+            schema = (
+                tom.model.Tables[tName].Partitions[part_name].Source.SchemaName or "dbo"
+            )
+            tom.model.Tables[tName].SourceLineageTag = f"[{schema}].[{eName}]"
             print(
                 f"{icons.green_dot} The '{tName}' table in the '{dataset_name}' semantic model within the '{workspace_name}' workspace has been updated to point to the '{eName}' table."
             )

sempy_labs/graph/_teams.py

@@ -35,7 +35,7 @@ def list_teams() -> pd.DataFrame:
         "Archived": "bool",
         "Favorite By Me": "bool",
         "Discoverable By Me": "bool",
-        "Member Count": "int",
+        "Member Count": "int_fillna",
     }
 
     df = _create_dataframe(columns=columns)

sempy_labs/graph/_users.py

@@ -125,6 +125,7 @@ def send_mail(
     subject: str,
     to_recipients: str | List[str],
     content: str,
+    content_type: str = "Text",
     cc_recipients: str | List[str] = None,
 ):
     """
@@ -144,10 +145,17 @@ def send_mail(
         The email address of the recipients.
     content : str
         The email content.
+    content_type : str, default="Text"
+        The email content type. Options: "Text" or "HTML".
     cc_recipients : str | List[str], default=None
         The email address of the CC recipients.
     """
 
+    if content_type.lower() == "html":
+        content_type = "HTML"
+    else:
+        content_type = "Text"
+
     user_id = resolve_user_id(user=user)
 
     if isinstance(to_recipients, str):
@@ -170,7 +178,7 @@ def send_mail(
         "message": {
             "subject": subject,
             "body": {
-                "contentType": "Text",
+                "contentType": content_type,
                 "content": content,
             },
             "toRecipients": to_email_addresses,