[6/n][dagster-powerbi] publish dagster-powerbi, add apidoc

docs/content/_apidocs.mdx

@@ -610,6 +610,16 @@ Dagster also provides a growing set of optional add-on libraries to integrate wi
         Includes implementations of run and event log storage built on Postgres.
       </td>
     </tr>
+    <tr>
+      <td>
+        <a href="/_apidocs/libraries/dagster-powerbi">Power BI</a> (
+        <code>dagster-powerbi</code>)
+      </td>
+      <td>
+        Provides an integration to represent a Power BI workspace as a graph of
+        assets.
+      </td>
+    </tr>
     <tr>
       <td>
         <a href="/_apidocs/libraries/dagster-prometheus">Prometheus</a> (

docs/content/_navigation.json

@@ -1532,6 +1532,10 @@
             "title": "PostgreSQL (dagster-postgres)",
             "path": "/_apidocs/libraries/dagster-postgres"
           },
+          {
+            "title": "Power BI (dagster-powerbi)",
+            "path": "/_apidocs/libraries/dagster-powerbi"
+          },
           {
             "title": "Prometheus (dagster-prometheus)",
             "path": "/_apidocs/libraries/dagster-prometheus"

docs/sphinx/conf.py

@@ -38,6 +38,7 @@
     "../../python_modules/libraries/dagster-github",
     "../../python_modules/libraries/dagster-k8s",
     "../../python_modules/libraries/dagster-looker",
+    "../../python_modules/libraries/dagster-powerbi",
     "../../python_modules/libraries/dagster-managed-elements",
     "../../python_modules/libraries/dagster-mlflow",
     "../../python_modules/libraries/dagster-msteams",

docs/sphinx/index.rst

@@ -67,6 +67,7 @@
    sections/api/apidocs/libraries/dagster-pipes
    sections/api/apidocs/libraries/dagster-polars
    sections/api/apidocs/libraries/dagster-postgres
+   sections/api/apidocs/libraries/dagster-powerbi
    sections/api/apidocs/libraries/dagster-prometheus
    sections/api/apidocs/libraries/dagster-pyspark
    sections/api/apidocs/libraries/dagster-shell

docs/sphinx/sections/api/apidocs/libraries/dagster-powerbi.rst

@@ -0,0 +1,17 @@
+##########################
+Power BI (dagster-powerbi)
+##########################
+
+Dagster allows you to represent your Power BI workspace as assets, alongside other your other
+technologies like dbt and Sling. This allows you to see how your Power BI assets are connected to
+your other data assets, and how changes to other data assets might impact your Power BI project.
+
+.. currentmodule:: dagster_powerbi
+
+
+Assets
+======
+
+.. autoclass:: DagsterPowerBITranslator
+
+.. autoclass:: PowerBIWorkspace

docs/tox.ini

@@ -45,6 +45,7 @@ deps =
   -e ../python_modules/libraries/dagster-deltalake-polars
   -e ../python_modules/libraries/dagster-openai
   -e ../python_modules/libraries/dagster-looker
+  -e ../python_modules/libraries/dagster-powerbi
 
 commands =
   make --directory=sphinx clean

python_modules/libraries/dagster-powerbi/dagster_powerbi/__init__.py

@@ -2,8 +2,6 @@
 
 from dagster_powerbi.resource import PowerBIWorkspace as PowerBIWorkspace
 from dagster_powerbi.translator import DagsterPowerBITranslator as DagsterPowerBITranslator
-
-# Move back to version.py and edit setup.py once we are ready to publish.
-__version__ = "1!0+dev"
+from dagster_powerbi.version import __version__
 
 DagsterLibraryRegistry.register("dagster-powerbi", __version__)

python_modules/libraries/dagster-powerbi/dagster_powerbi/resource.py

@@ -7,6 +7,7 @@
     _check as check,
     external_assets_from_specs,
 )
+from dagster._annotations import public
 from dagster._core.definitions.cacheable_assets import (
     AssetsDefinitionCacheableData,
     CacheableAssetsDefinition,
@@ -24,6 +25,7 @@
 BASE_API_URL = "https://api.powerbi.com/v1.0/myorg/"
 
 
+@public
 class PowerBIWorkspace(ConfigurableResource):
     """Represents a workspace in PowerBI and provides utilities
     to interact with the PowerBI API.
@@ -125,6 +127,7 @@ def fetch_powerbi_workspace_data(
             dashboards + reports + semantic_models + list(data_sources_by_id.values()),
         )
 
+    @public
     def build_assets(
         self,
         dagster_powerbi_translator: Type[DagsterPowerBITranslator] = DagsterPowerBITranslator,

python_modules/libraries/dagster-powerbi/dagster_powerbi/translator.py

@@ -4,6 +4,7 @@
 from typing import Any, Dict, Mapping, Sequence
 
 from dagster import _check as check
+from dagster._annotations import public
 from dagster._core.definitions.asset_key import AssetKey
 from dagster._core.definitions.asset_spec import AssetSpec
 from dagster._record import record
@@ -97,6 +98,7 @@ def from_content_data(
         )
 
 
+@public
 class DagsterPowerBITranslator:
     """Translator class which converts raw response data from the PowerBI API into AssetSpecs.
     Subclass this class to implement custom logic for each type of PowerBI content.

python_modules/libraries/dagster-powerbi/dagster_powerbi/version.py

@@ -0,0 +1 @@
+__version__ = "1!0+dev"

python_modules/libraries/dagster-powerbi/setup.py

@@ -1,14 +1,15 @@
+from pathlib import Path
+from typing import Dict
+
 from setuptools import find_packages, setup
 
 
 def get_version() -> str:
-    return "1!0+dev"
-    # Uncomment when ready to publish
-    # version: Dict[str, str] = {}
-    # with open(Path(__file__).parent / "dagster_powerbi/version.py", encoding="utf8") as fp:
-    #     exec(fp.read(), version)
+    version: Dict[str, str] = {}
+    with open(Path(__file__).parent / "dagster_powerbi/version.py", encoding="utf8") as fp:
+        exec(fp.read(), version)
 
-    # return version["__version__"]
+    return version["__version__"]
 
 
 ver = get_version()