semantic-link-labs 0.9.4__tar.gz → 0.9.5__tar.gz

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: semantic-link-labs
-Version: 0.9.4
+Version: 0.9.5
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Requires-Dist: pytest>=8.2.1; extra == "test"
 # 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.4&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.5&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)
 
@@ -34,6 +34,9 @@ Requires-Dist: pytest>=8.2.1; extra == "test"
 [Read the documentation on ReadTheDocs!](https://semantic-link-labs.readthedocs.io/en/stable/)
 ---
 
+[Read the Wiki!](https://github.com/microsoft/semantic-link-labs/wiki)
+---
+
 Semantic Link Labs is a Python library designed for use in [Microsoft Fabric notebooks](https://learn.microsoft.com/fabric/data-engineering/how-to-use-notebook). This library extends the capabilities of [Semantic Link](https://learn.microsoft.com/fabric/data-science/semantic-link-overview) offering additional functionalities to seamlessly integrate and work alongside it. The goal of Semantic Link Labs is to simplify technical processes, empowering people to focus on higher level activities and allowing tasks that are better suited for machines to be efficiently handled without human intervention.
 
 If you encounter any issues, please [raise a bug](https://github.com/microsoft/semantic-link-labs/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=).
@@ -145,6 +148,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.9.5](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.5) (March 7, 2025)
 * [0.9.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.4) (February 27, 2025)
 * [0.9.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.3) (February 13, 2025)
 * [0.9.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.2) (February 5, 2025)
@@ -299,6 +303,18 @@ python -m build
 4. Enter details into the description.
 5. Click 'Create'.
 
+#### Code Formatting
+We use [black](github.com/psf/black) formatting as a code formatting standard. Make sure to run 'black' formatting on your code before submitting a pull request.
+
+Run this code to install black
+```cli
+pip install black
+```
+
+Run this code to format your code using black
+```cli
+python -m black src
+```
 
 ## Trademarks
 

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/README.md

@@ -1,7 +1,7 @@
 # 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.4&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.5&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)
 
@@ -9,6 +9,9 @@
 [Read the documentation on ReadTheDocs!](https://semantic-link-labs.readthedocs.io/en/stable/)
 ---
 
+[Read the Wiki!](https://github.com/microsoft/semantic-link-labs/wiki)
+---
+
 Semantic Link Labs is a Python library designed for use in [Microsoft Fabric notebooks](https://learn.microsoft.com/fabric/data-engineering/how-to-use-notebook). This library extends the capabilities of [Semantic Link](https://learn.microsoft.com/fabric/data-science/semantic-link-overview) offering additional functionalities to seamlessly integrate and work alongside it. The goal of Semantic Link Labs is to simplify technical processes, empowering people to focus on higher level activities and allowing tasks that are better suited for machines to be efficiently handled without human intervention.
 
 If you encounter any issues, please [raise a bug](https://github.com/microsoft/semantic-link-labs/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=).
@@ -120,6 +123,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.9.5](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.5) (March 7, 2025)
 * [0.9.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.4) (February 27, 2025)
 * [0.9.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.3) (February 13, 2025)
 * [0.9.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.2) (February 5, 2025)
@@ -274,6 +278,18 @@ python -m build
 4. Enter details into the description.
 5. Click 'Create'.
 
+#### Code Formatting
+We use [black](github.com/psf/black) formatting as a code formatting standard. Make sure to run 'black' formatting on your code before submitting a pull request.
+
+Run this code to install black
+```cli
+pip install black
+```
+
+Run this code to format your code using black
+```cli
+python -m black src
+```
 
 ## Trademarks
 

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/docs/source/conf.py

@@ -13,7 +13,7 @@ sys.path.insert(0, os.path.abspath('../../src/'))
 project = 'semantic-link-labs'
 copyright = '2024, Microsoft and community'
 author = 'Microsoft and community'
-release = '0.9.4'
+release = '0.9.5'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/pyproject.toml

@@ -7,7 +7,7 @@ name="semantic-link-labs"
 authors = [
     { name = "Microsoft Corporation" },
 ]
-version="0.9.4"
+version="0.9.5"
 description="Semantic Link Labs for Microsoft Fabric"
 readme="README.md"
 requires-python=">=3.10,<3.12"

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/src/semantic_link_labs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: semantic-link-labs
-Version: 0.9.4
+Version: 0.9.5
 Summary: Semantic Link Labs for Microsoft Fabric
 Author: Microsoft Corporation
 License: MIT License
@@ -26,7 +26,7 @@ Requires-Dist: pytest>=8.2.1; extra == "test"
 # 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.4&style=flat)](https://readthedocs.org/projects/semantic-link-labs/)
+[![Read The Docs](https://readthedocs.org/projects/semantic-link-labs/badge/?version=0.9.5&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)
 
@@ -34,6 +34,9 @@ Requires-Dist: pytest>=8.2.1; extra == "test"
 [Read the documentation on ReadTheDocs!](https://semantic-link-labs.readthedocs.io/en/stable/)
 ---
 
+[Read the Wiki!](https://github.com/microsoft/semantic-link-labs/wiki)
+---
+
 Semantic Link Labs is a Python library designed for use in [Microsoft Fabric notebooks](https://learn.microsoft.com/fabric/data-engineering/how-to-use-notebook). This library extends the capabilities of [Semantic Link](https://learn.microsoft.com/fabric/data-science/semantic-link-overview) offering additional functionalities to seamlessly integrate and work alongside it. The goal of Semantic Link Labs is to simplify technical processes, empowering people to focus on higher level activities and allowing tasks that are better suited for machines to be efficiently handled without human intervention.
 
 If you encounter any issues, please [raise a bug](https://github.com/microsoft/semantic-link-labs/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=).
@@ -145,6 +148,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.9.5](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.5) (March 7, 2025)
 * [0.9.4](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.4) (February 27, 2025)
 * [0.9.3](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.3) (February 13, 2025)
 * [0.9.2](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.2) (February 5, 2025)
@@ -299,6 +303,18 @@ python -m build
 4. Enter details into the description.
 5. Click 'Create'.
 
+#### Code Formatting
+We use [black](github.com/psf/black) formatting as a code formatting standard. Make sure to run 'black' formatting on your code before submitting a pull request.
+
+Run this code to install black
+```cli
+pip install black
+```
+
+Run this code to format your code using black
+```cli
+python -m black src
+```
 
 ## Trademarks
 

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/src/semantic_link_labs.egg-info/SOURCES.txt

@@ -43,6 +43,7 @@ src/sempy_labs/_capacities.py
 src/sempy_labs/_capacity_migration.py
 src/sempy_labs/_clear_cache.py
 src/sempy_labs/_connections.py
+src/sempy_labs/_dashboards.py
 src/sempy_labs/_data_pipelines.py
 src/sempy_labs/_dataflows.py
 src/sempy_labs/_dax.py
@@ -73,6 +74,7 @@ src/sempy_labs/_model_bpa.py
 src/sempy_labs/_model_bpa_bulk.py
 src/sempy_labs/_model_bpa_rules.py
 src/sempy_labs/_model_dependencies.py
+src/sempy_labs/_mounted_data_factories.py
 src/sempy_labs/_notebooks.py
 src/sempy_labs/_one_lake_integration.py
 src/sempy_labs/_query_scale_out.py
@@ -82,6 +84,7 @@ src/sempy_labs/_spark.py
 src/sempy_labs/_sql.py
 src/sempy_labs/_sqldatabase.py
 src/sempy_labs/_translations.py
+src/sempy_labs/_utils.py
 src/sempy_labs/_vertipaq.py
 src/sempy_labs/_warehouses.py
 src/sempy_labs/_workloads.py
@@ -128,6 +131,7 @@ src/sempy_labs/_bpa_translation/_model/_translations_zu-ZA.po
 src/sempy_labs/admin/__init__.py
 src/sempy_labs/admin/_activities.py
 src/sempy_labs/admin/_apps.py
+src/sempy_labs/admin/_artifacts.py
 src/sempy_labs/admin/_basic_functions.py
 src/sempy_labs/admin/_capacities.py
 src/sempy_labs/admin/_datasets.py
@@ -139,6 +143,8 @@ src/sempy_labs/admin/_reports.py
 src/sempy_labs/admin/_scanner.py
 src/sempy_labs/admin/_shared.py
 src/sempy_labs/admin/_tenant.py
+src/sempy_labs/admin/_users.py
+src/sempy_labs/admin/_workspaces.py
 src/sempy_labs/directlake/__init__.py
 src/sempy_labs/directlake/_directlake_schema_compare.py
 src/sempy_labs/directlake/_directlake_schema_sync.py
@@ -216,5 +222,4 @@ src/sempy_labs/tom/__init__.py
 src/sempy_labs/tom/_model.py
 tests/__init__.py
 tests/test_friendly_case.py
-tests/test_shortcuts.py
 tests/test_tom.py

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/src/sempy_labs/__init__.py

@@ -1,3 +1,9 @@
+from sempy_labs._mounted_data_factories import (
+    list_mounted_data_factories,
+    get_mounted_data_factory_definition,
+    delete_mounted_data_factory,
+)
+
 from sempy_labs._semantic_models import (
     get_semantic_model_refresh_schedule,
     enable_semantic_model_scheduled_refresh,
@@ -99,7 +105,7 @@ from sempy_labs._kql_querysets import (
 )
 from sempy_labs._kql_databases import (
     list_kql_databases,
-    create_kql_database,
+    # create_kql_database,
     delete_kql_database,
 )
 from sempy_labs._mirrored_warehouses import list_mirrored_warehouses
@@ -193,6 +199,8 @@ from sempy_labs._git import (
     connect_workspace_to_azure_dev_ops,
     connect_workspace_to_github,
     disconnect_workspace_from_git,
+    get_my_git_credentials,
+    update_my_git_credentials,
 )
 from sempy_labs._dataflows import (
     list_dataflow_storage_accounts,
@@ -226,6 +234,9 @@ from sempy_labs._generate_semantic_model import (
     update_semantic_model_from_bim,
     get_semantic_model_definition,
 )
+from sempy_labs._dashboards import (
+    list_dashboards,
+)
 from sempy_labs._list_functions import (
     list_reports_using_semantic_model,
     list_semantic_model_object_report_usage,
@@ -234,7 +245,6 @@ from sempy_labs._list_functions import (
     list_shortcuts,
     get_object_level_security,
     list_capacities,
-    list_dashboards,
     list_datamarts,
     list_lakehouses,
     list_sql_endpoints,
@@ -425,7 +435,7 @@ __all__ = [
     "convert_to_friendly_case",
     "list_mirrored_warehouses",
     "list_kql_databases",
-    "create_kql_database",
+    # "create_kql_database",
     "delete_kql_database",
     "create_eventhouse",
     "list_eventhouses",
@@ -525,4 +535,9 @@ __all__ = [
     "create_item_schedule_cron",
     "create_item_schedule_daily",
     "create_item_schedule_weekly",
+    "get_my_git_credentials",
+    "update_my_git_credentials",
+    "list_mounted_data_factories",
+    "get_mounted_data_factory_definition",
+    "delete_mounted_data_factory",
 ]

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/src/sempy_labs/_capacities.py

@@ -256,7 +256,6 @@ def suspend_fabric_capacity(
     capacity_name: str,
     azure_subscription_id: str,
     resource_group: str,
-    **kwargs,
 ):
     """
     This function suspends a Fabric capacity.
@@ -275,26 +274,9 @@ def suspend_fabric_capacity(
         The name of the Azure resource group.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}/suspend?api-version={icons.azure_api_version}"
 
-    response = requests.post(url, headers=headers)
-
-    if response.status_code != 202:
-        raise FabricHTTPException(response)
+    _base_api(request=url, client="azure", method="post", status_codes=202)
 
     print(f"{icons.green_dot} The '{capacity_name}' capacity has been suspended.")
 
@@ -304,7 +286,6 @@ def resume_fabric_capacity(
     capacity_name: str,
     azure_subscription_id: str,
     resource_group: str,
-    **kwargs,
 ):
     """
     This function resumes a Fabric capacity.
@@ -323,26 +304,9 @@ def resume_fabric_capacity(
         The name of the Azure resource group.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}/resume?api-version={icons.azure_api_version}"
 
-    response = requests.post(url, headers=headers)
-
-    if response.status_code != 202:
-        raise FabricHTTPException(response)
+    _base_api(request=url, client="azure", method="post", status_codes=202)
 
     print(f"{icons.green_dot} The '{capacity_name}' capacity has been resumed.")
 
@@ -352,7 +316,6 @@ def delete_embedded_capacity(
     capacity_name: str,
     azure_subscription_id: str,
     resource_group: str,
-    **kwargs,
 ):
     """
     This function deletes a Power BI Embedded capacity.
@@ -369,53 +332,36 @@ def delete_embedded_capacity(
         The name of the Azure resource group.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.PowerBIDedicated/capacities/{capacity_name}?api-version={icons.azure_api_version}"
 
-    response = requests.delete(url, headers=headers)
-
-    if response.status_code not in [200, 202]:
-        raise FabricHTTPException(response)
+    _base_api(request=url, client="azure", method="delete", status_codes=[200, 202])
 
     print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
 
 @log
-def delete_premium_capacity(capacity_name: str):
+def delete_premium_capacity(capacity: str | UUID, **kwargs):
     """
     This function deletes a Power BI Premium capacity.
 
     Parameters
     ----------
-    capacity_name : str
-        Name of the Fabric capacity.
+    capacity : str | uuid.UUID
+        Name or ID of the Fabric capacity.
     """
+    from sempy_labs._helper_functions import resolve_capacity_id
 
-    dfC = fabric.list_capacities()
-
-    dfC_filt = dfC[dfC["Display Name"] == capacity_name]
-    if len(dfC_filt) == 0:
-        raise ValueError(
-            f"{icons.red_dot} The '{capacity_name}' capacity does not exist."
+    if "capacity_name" in kwargs:
+        capacity = kwargs["capacity_name"]
+        print(
+            f"{icons.warning} The 'capacity_name' parameter is deprecated. Please use 'capacity' instead."
         )
-    capacity_id = dfC_filt["Id"].iloc[0].upper()
+
+    capacity_id = resolve_capacity_id(capacity=capacity).upper()
 
     _base_api(request=f"capacities/{capacity_id}", method="delete", status_codes=204)
 
-    print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
+    print(f"{icons.green_dot} The '{capacity}' capacity has been deleted.")
 
 
 @log
@@ -423,7 +369,6 @@ def delete_fabric_capacity(
     capacity_name: str,
     azure_subscription_id: str,
     resource_group: str,
-    **kwargs,
 ):
     """
     This function deletes a Fabric capacity.
@@ -442,26 +387,9 @@ def delete_fabric_capacity(
         The name of the Azure resource group.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}?api-version={icons.azure_api_version}"
 
-    response = requests.delete(url, headers=headers)
-
-    if response.status_code != 202:
-        raise FabricHTTPException(response)
+    _base_api(request=url, client="azure", method="delete", status_codes=202)
 
     print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
@@ -474,7 +402,6 @@ def update_fabric_capacity(
     sku: Optional[str] = None,
     admin_members: Optional[str | List[str]] = None,
     tags: Optional[dict] = None,
-    **kwargs,
 ):
     """
     This function updates a Fabric capacity's properties.
@@ -499,25 +426,9 @@ def update_fabric_capacity(
         Tag(s) to add to the capacity. Example: {'tagName': 'tagValue'}.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}?api-version={icons.azure_api_version}"
 
-    get_response = requests.get(url, headers=headers)
-    if get_response.status_code != 200:
-        raise FabricHTTPException(get_response)
+    get_response = _base_api(request=url, client="azure")
 
     get_json = get_response.json()
     current_sku = get_json.get("sku", {}).get("name")
@@ -549,10 +460,9 @@ def update_fabric_capacity(
         return
 
     payload = _add_sll_tag(payload, tags)
-    response = requests.patch(url, headers=headers, json=payload)
-
-    if response.status_code != 202:
-        raise FabricHTTPException(response)
+    _base_api(
+        request=url, client="azure", method="patch", payload=payload, status_codes=202
+    )
 
     print(
         f"{icons.green_dot} The '{capacity_name}' capacity has been updated accordingly."
@@ -588,28 +498,13 @@ def check_fabric_capacity_name_availablility(
         An indication as to whether the Fabric capacity name is available or not.
     """
 
-    token_provider = auth.token_provider.get()
-    if token_provider is None:
-        token_provider = ServicePrincipalTokenProvider.from_azure_key_vault(
-            key_vault_uri=kwargs["key_vault_uri"],
-            key_vault_tenant_id=kwargs["key_vault_tenant_id"],
-            key_vault_client_id=kwargs["key_vault_client_id"],
-            key_vault_client_secret=kwargs["key_vault_client_secret"],
-        )
-        print(
-            f"{icons.info} Please use the 'token_provider' parameter instead of the key vault parameters within this function as the key vault parameters have been deprecated."
-        )
-
-    headers = _get_headers(token_provider, audience="azure")
-
     payload = {"name": capacity_name, "type": "Microsoft.Fabric/capacities"}
 
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/providers/Microsoft.Fabric/locations/{region}/checkNameAvailability?api-version={icons.azure_api_version}"
 
-    response = requests.post(url, headers=headers, json=payload)
-
-    if response.status_code != 202:
-        raise FabricHTTPException(response)
+    response = _base_api(
+        request=url, client="azure", method="post", payload=payload, status_codes=202
+    )
 
     return bool(response.json().get("nameAvailable"))
 

{semantic_link_labs-0.9.4 → semantic_link_labs-0.9.5}/src/sempy_labs/_capacity_migration.py

@@ -16,6 +16,7 @@ from sempy_labs._helper_functions import (
     _base_api,
 )
 from sempy_labs._capacities import create_fabric_capacity
+from uuid import UUID
 
 
 def _migrate_settings(source_capacity: str, target_capacity: str):
@@ -531,7 +532,7 @@ def _migrate_delegated_tenant_settings(source_capacity: str, target_capacity: st
 
 
 @log
-def _migrate_spark_settings(source_capacity: str, target_capacity: str):
+def _migrate_spark_settings(source_capacity: str | UUID, target_capacity: str | UUID):
     """
     This function migrates a capacity's spark settings to another capacity.
 
@@ -539,14 +540,14 @@ def _migrate_spark_settings(source_capacity: str, target_capacity: str):
 
     Parameters
     ----------
-    source_capacity : str
-        Name of the source capacity.
-    target_capacity : str
-        Name of the target capacity.
+    source_capacity : str | uuid.UUID
+        Name or ID of the source capacity.
+    target_capacity : str | uuid.UUID
+        Name or ID of the target capacity.
     """
 
-    source_capacity_id = resolve_capacity_id(capacity_name=source_capacity)
-    target_capacity_id = resolve_capacity_id(capacity_name=target_capacity)
+    source_capacity_id = resolve_capacity_id(capacity=source_capacity)
+    target_capacity_id = resolve_capacity_id(capacity=target_capacity)
 
     # Get source capacity server dns
     response = _base_api(request=f"metadata/capacityInformation/{source_capacity_id}")

semantic_link_labs-0.9.5/src/sempy_labs/_dashboards.py

@@ -0,0 +1,60 @@
+from typing import Optional
+from uuid import UUID
+import pandas as pd
+from sempy_labs._helper_functions import (
+    _create_dataframe,
+    _base_api,
+    resolve_workspace_name_and_id,
+    _update_dataframe_datatypes,
+)
+
+
+def list_dashboards(workspace: Optional[str | UUID] = None) -> pd.DataFrame:
+    """
+    Shows a list of the dashboards within a workspace.
+
+    Parameters
+    ----------
+    workspace : str | uuid.UUID, default=None
+        The Fabric workspace name or ID.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the dashboards within a workspace.
+    """
+
+    columns = {
+        "Dashboard ID": "string",
+        "Dashboard Name": "string",
+        "Read Only": "bool",
+        "Web URL": "string",
+        "Embed URL": "string",
+        "Data Classification": "string",
+        "Users": "string",
+        "Subscriptions": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    (workspace_name, workspace_id) = resolve_workspace_name_and_id(workspace)
+
+    response = _base_api(request=f"/v1.0/myorg/groups/{workspace_id}/dashboards")
+
+    for v in response.json().get("value", []):
+        new_data = {
+            "Dashboard ID": v.get("id"),
+            "Dashboard Name": v.get("displayName"),
+            "Read Only": v.get("isReadOnly"),
+            "Web URL": v.get("webUrl"),
+            "Embed URL": v.get("embedUrl"),
+            "Data Classification": v.get("dataClassification"),
+            "Users": v.get("users"),
+            "Subscriptions": v.get("subscriptions"),
+        }
+        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    _update_dataframe_datatypes(dataframe=df, column_map=columns)
+
+    return df