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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: semantic-link-labs
-Version: 0.9.4
+Version: 0.9.6
 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.6&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,8 @@ 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.6](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.6) (March 12, 2025)
+* [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 +304,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.6}/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.6&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,8 @@ 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.6](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.6) (March 12, 2025)
+* [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 +279,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.6}/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.6'
 
 # -- 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.6}/notebooks/Service Principal.ipynb

@@ -144,7 +144,7 @@
     "    key_vault_client_secret=key_vault_client_secret):\n",
     "\n",
     "    labs.suspend_fabric_capacity(\n",
-    "        capacity_name='',\n",
+    "        capacity='',\n",
     "        azure_subscription_id='',\n",
     "        resource_group='',\n",
     "    )"

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

@@ -7,7 +7,7 @@ name="semantic-link-labs"
 authors = [
     { name = "Microsoft Corporation" },
 ]
-version="0.9.4"
+version="0.9.6"
 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.6}/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.6
 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.6&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,8 @@ 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.6](https://github.com/microsoft/semantic-link-labs/releases/tag/0.9.6) (March 12, 2025)
+* [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 +304,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.6}/src/semantic_link_labs.egg-info/SOURCES.txt

@@ -43,9 +43,11 @@ 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
+src/sempy_labs/_dax_query_view.py
 src/sempy_labs/_delta_analyzer.py
 src/sempy_labs/_deployment_pipelines.py
 src/sempy_labs/_documentation.py
@@ -73,6 +75,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 +85,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 +132,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 +144,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 +223,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.6}/src/sempy_labs/__init__.py

@@ -1,6 +1,16 @@
+from sempy_labs._dax_query_view import (
+    generate_dax_query_view_url,
+)
+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,
+    delete_semantic_model,
 )
 from sempy_labs._graphQL import (
     list_graphql_apis,
@@ -99,7 +109,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
@@ -142,6 +152,7 @@ from sempy_labs._capacities import (
     create_or_update_resource_group,
     list_resource_groups,
     get_resource_group,
+    list_capacities,
 )
 from sempy_labs._spark import (
     get_spark_settings,
@@ -159,6 +170,7 @@ from sempy_labs._workspaces import (
     assign_workspace_to_capacity,
     unassign_workspace_from_capacity,
     list_workspace_role_assignments,
+    delete_workspace,
 )
 from sempy_labs._notebooks import (
     get_notebook_definition,
@@ -174,6 +186,9 @@ from sempy_labs._sql import (
 from sempy_labs._sqldatabase import (
     get_sql_database_columns,
     get_sql_database_tables,
+    create_sql_database,
+    delete_sql_database,
+    list_sql_databases,
 )
 from sempy_labs._workspace_identity import (
     provision_workspace_identity,
@@ -193,6 +208,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 +243,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,
@@ -233,8 +253,6 @@ from sempy_labs._list_functions import (
     list_semantic_model_objects,
     list_shortcuts,
     get_object_level_security,
-    list_capacities,
-    list_dashboards,
     list_datamarts,
     list_lakehouses,
     list_sql_endpoints,
@@ -425,7 +443,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 +543,15 @@ __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",
+    "generate_dax_query_view_url",
+    "delete_semantic_model",
+    "delete_workspace",
+    "create_sql_database",
+    "delete_sql_database",
+    "list_sql_databases",
 ]

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

@@ -242,7 +242,7 @@ def list_vcores() -> pd.DataFrame:
 
 def get_capacity_resource_governance(capacity_name: str):
 
-    dfC = fabric.list_capacities()
+    dfC = list_capacities()
     dfC_filt = dfC[dfC["Display Name"] == capacity_name]
     capacity_id = dfC_filt["Id"].iloc[0].upper()
 
@@ -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"))
 
@@ -1236,3 +1131,39 @@ def get_resource_group(azure_subscription_id: str, resource_group: str) -> pd.Da
     }
 
     return pd.DataFrame(new_data, index=[0])
+
+
+def list_capacities() -> pd.DataFrame:
+    """
+    Shows the capacities and their properties.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the capacities and their properties
+    """
+
+    columns = {
+        "Id": "string",
+        "Display Name": "string",
+        "Sku": "string",
+        "Region": "string",
+        "State": "string",
+        "Admins": "string",
+    }
+    df = _create_dataframe(columns=columns)
+
+    response = _base_api(request="/v1.0/myorg/capacities", client="fabric_sp")
+
+    for i in response.json().get("value", []):
+        new_data = {
+            "Id": i.get("id").lower(),
+            "Display Name": i.get("displayName"),
+            "Sku": i.get("sku"),
+            "Region": i.get("region"),
+            "State": i.get("state"),
+            "Admins": [i.get("admins", [])],
+        }
+        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    return df