fabric-pbi 1.0.0__py3-none-any.whl

fabric_pbi-1.0.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: fabric-pbi
+Version: 1.0.0
+Summary: Microsoft Fabric REST API client
+Author-email: Your Name <you@example.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: python-dotenv
+Requires-Dist: msal
+
+# Fabric PBI Client
+
+Python client for the Microsoft Fabric REST API.
+
+## Install
+
+```bash
+pip install fabric-pbi
+```
+
+## Quick start
+
+```python
+from fabricpandas import FabricClient
+
+client = FabricClient()
+workspaces = client.list_workspaces()
+```
+
+Example `.env` for quick start:
+
+```env
+FABRIC_ACCESS_TOKEN=your_access_token_here
+```
+
+## Authentication
+
+Authentication is loaded from a `.env` file (default) or your shell. You can:
+
+- Provide a bearer token directly, or
+- Use service principal credentials to request a token via MSAL, or
+- Use interactive login via system browser.
+
+### Option 1: Access token
+
+Set an access token as an environment variable:
+
+- `FABRIC_ACCESS_TOKEN` (preferred if you already have a token), or
+- `tenant_id`, `client_id`, `client_secret` (service principal)
+
+Example `.env`:
+
+```env
+FABRIC_ACCESS_TOKEN=your_access_token_here
+```
+
+### Option 2: Service principal (MSAL)
+
+Set your Azure AD app credentials in `.env`:
+
+```env
+tenant_id=your_tenant_id
+client_id=your_client_id
+client_secret=your_client_secret
+```
+
+The client will request a token for:
+
+- `https://analysis.windows.net/powerbi/api/.default`
+
+Install MSAL if you use service principal auth:
+
+```bash
+pip install msal
+```
+
+### Option 3: Interactive login (system browser)
+
+Configure a public client app in Azure AD and add a redirect URI of `http://localhost`.
+Set your app and tenant IDs in `.env`:
+
+```env
+tenant_id=your_tenant_id
+client_id=your_client_id
+```
+
+Usage:
+
+```python
+from fabricpandas import FabricClient
+
+client = FabricClient(interactive_login=True)
+```
+
+Or request a token directly:
+
+```python
+from fabricpandas.auth import get_fabric_token_interactive
+
+token = get_fabric_token_interactive()
+```
+
+### Custom `.env` path
+
+Pass a custom env file path when constructing the client:
+
+```python
+from fabricpandas import FabricClient
+
+client = FabricClient(env_file="path/to/.env")
+```
+
+## Troubleshooting auth
+
+- `Missing required environment variables`: set `FABRIC_ACCESS_TOKEN` or all of `tenant_id`, `client_id`, `client_secret`.
+- `Missing required environment variables for interactive login`: set `tenant_id` and `client_id` and ensure your app is a public client with `http://localhost` redirect URI.
+- `msal library is required`: install MSAL with `pip install msal`.
+- `Failed to acquire token`: verify Azure AD app credentials and that the app has access to Fabric APIs.
+

fabric_pbi-1.0.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+fabricpandas/__init__.py,sha256=izM-WZUo6M4PhZXbazgH15VtBWH5dI9_z1ajiV7kTYs,692
+fabricpandas/client.py,sha256=EofRt94ZQdwuuJ-GdAGtVvD2m55ChpGedmyVUCgaWTk,3063
+fabricpandas/auth/__init__.py,sha256=z3OS4MxHLNI9pXE9wMOB0kTRTtn5v8q0UrInKRp2I4U,249
+fabricpandas/auth/base_client.py,sha256=QYwvSsrqiQmqWTksoxDIrSv8pXLMipgOkOcvlDUOuu4,7271
+fabricpandas/bulks/__init__.py,sha256=5NLN5zmSLXDm9yHrF-LaCHIe8twX0w0rPV6xnk8mQ0U,120
+fabricpandas/bulks/bulk_client.py,sha256=xPRLVoY2c7uz_q9OxDvJyA3upEFVGbnIKHWsM5KOsP8,30903
+fabricpandas/report/__init__.py,sha256=FOOM6hi8_a4uXWxZEMeA4XCpQrAHQ8phxXeYpNSISrE,117
+fabricpandas/report/report_client.py,sha256=Dn-Cdhh8dAGJ_2d-CNqUpz5SdMVwrrV4fFfUM3a8z2Q,19761
+fabricpandas/semantic_model/__init__.py,sha256=A9YGRIhrIbn8sRDcCP7VFqzonS6ZygY6yv9oJfKY6gc,147
+fabricpandas/semantic_model/semantic_model_client.py,sha256=aqloSB8wSQvOi3XrcfZCu7l7MUIEN4EV2vjpAi4ATrg,25899
+fabricpandas/utils/__init__.py,sha256=JdjwEJDjbQ_n6B0N2gF3JCNW6g05yGG4OpIYvor6hFE,64
+fabricpandas/workspace/__init__.py,sha256=_-jTljVxZhw93k7mr2X5DaIzqTHxTZ0H2D-vp7-cdes,129
+fabricpandas/workspace/workspace_client.py,sha256=4G3zKjmyazBO9-b5IeXidQicXdjI76IpQSYhOmN2YeI,5021
+fabric_pbi-1.0.0.dist-info/METADATA,sha256=aZxltsOJQa9ozhVWFP9t4H4E7FGHXs9eTdR24EKPVm4,2954
+fabric_pbi-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+fabric_pbi-1.0.0.dist-info/top_level.txt,sha256=-4vRijt7KCdbmlOm7SCjHjp16lzLiHjhQBvB4ftnvvs,13
+fabric_pbi-1.0.0.dist-info/RECORD,,

fabric_pbi-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fabric_pbi-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fabricpandas

fabricpandas/__init__.py

@@ -0,0 +1,22 @@
+"""
+FabricPandas - Microsoft Fabric REST API Client
+A Python client for interacting with Microsoft Fabric APIs
+"""
+
+from .client import FabricClient
+from .workspace import WorkspaceClient
+from .semantic_model import SemanticModelClient
+from .report import ReportClient
+from .bulks import BulkClient
+from .auth import BaseClient
+
+__version__ = "1.0.0"
+__all__ = [
+    "FabricClient",        # Main convenience class
+    "BaseClient",          # Base authentication class
+    "WorkspaceClient",     # Workspace operations
+    "SemanticModelClient", # Semantic Model operations
+    "ReportClient",        # Report operations
+    "BulkClient",          # Bulk operations
+]
+

fabricpandas/auth/__init__.py

@@ -0,0 +1,8 @@
+"""
+Authentication module for FabricPandas
+"""
+
+from .base_client import BaseClient, FabricConfig, get_fabric_token, get_fabric_token_interactive
+
+__all__ = ["BaseClient", "FabricConfig", "get_fabric_token", "get_fabric_token_interactive"]
+

fabricpandas/auth/base_client.py

@@ -0,0 +1,220 @@
+"""
+Base Fabric API Client
+Provides core functionality for Microsoft Fabric REST API interactions.
+"""
+
+import requests
+from typing import Optional, Dict, Any
+from dataclasses import dataclass
+
+
+def get_fabric_token(env_file: str = ".env") -> str:
+    """
+    Get Fabric access token from .env file
+    
+    Args:
+        env_file: Path to .env file
+        
+    Returns:
+        Access token string
+    """
+    import os
+    from dotenv import load_dotenv
+    
+    # Load environment variables
+    load_dotenv(env_file)
+    
+    # Check if we already have an access token in env
+    access_token = os.getenv("FABRIC_ACCESS_TOKEN")
+    if access_token:
+        return access_token
+    
+    # Otherwise, get token using service principal
+    tenant_id = os.getenv("tenant_id")
+    client_id = os.getenv("client_id")
+    client_secret = os.getenv("client_secret")
+    
+    if not all([tenant_id, client_id, client_secret]):
+        raise ValueError(
+            "Missing required environment variables. Please set either:\n"
+            "  - FABRIC_ACCESS_TOKEN\n"
+            "Or:\n"
+            "  - tenant_id, client_id, client_secret"
+        )
+    
+    # Get token using MSAL
+    try:
+        import msal
+        
+        authority = f"https://login.microsoftonline.com/{tenant_id}"
+        app = msal.ConfidentialClientApplication(
+            client_id=client_id,
+            authority=authority,
+            client_credential=client_secret
+        )
+        
+        # Fabric API scope
+        scopes = ["https://analysis.windows.net/powerbi/api/.default"]
+        
+        result = app.acquire_token_for_client(scopes=scopes)
+        
+        if "access_token" in result:
+            return result["access_token"]
+        else:
+            error = result.get("error_description", result.get("error", "Unknown error"))
+            raise Exception(f"Failed to acquire token: {error}")
+            
+    except ImportError:
+        raise ImportError(
+            "msal library is required for service principal authentication. "
+            "Install it with: pip install msal"
+        )
+
+
+def get_fabric_token_interactive(
+    env_file: str = ".env",
+    tenant_id: Optional[str] = None,
+    client_id: Optional[str] = None,
+    redirect_uri: str = "http://localhost",
+    scopes: Optional[list] = None
+) -> str:
+    """
+    Get Fabric access token using interactive login in a system browser.
+    
+    Args:
+        env_file: Path to .env file
+        tenant_id: Azure AD tenant ID (optional; falls back to env)
+        client_id: Azure AD app client ID (optional; falls back to env)
+        redirect_uri: Redirect URI for the public client app
+        scopes: Optional list of scopes to request
+        
+    Returns:
+        Access token string
+    """
+    import os
+    from dotenv import load_dotenv
+    
+    load_dotenv(env_file)
+    
+    resolved_tenant_id = tenant_id or os.getenv("tenant_id")
+    resolved_client_id = client_id or os.getenv("client_id")
+    
+    if not all([resolved_tenant_id, resolved_client_id]):
+        raise ValueError(
+            "Missing required environment variables for interactive login. "
+            "Please set tenant_id and client_id."
+        )
+    
+    try:
+        import msal
+        
+        authority = f"https://login.microsoftonline.com/{resolved_tenant_id}"
+        app = msal.PublicClientApplication(
+            client_id=resolved_client_id,
+            authority=authority
+        )
+        
+        requested_scopes = scopes or ["https://analysis.windows.net/powerbi/api/.default"]
+        
+        result = app.acquire_token_interactive(
+            scopes=requested_scopes,
+            redirect_uri=redirect_uri
+        )
+        
+        if "access_token" in result:
+            return result["access_token"]
+        
+        error = result.get("error_description", result.get("error", "Unknown error"))
+        raise Exception(f"Failed to acquire token interactively: {error}")
+        
+    except ImportError:
+        raise ImportError(
+            "msal library is required for interactive authentication. "
+            "Install it with: pip install msal"
+        )
+
+
+@dataclass
+class FabricConfig:
+    """Configuration for Fabric API client"""
+    base_url: str = "https://api.fabric.microsoft.com/v1"
+    access_token: Optional[str] = None
+
+
+class BaseClient:
+    """Base client for Microsoft Fabric API interactions"""
+    
+    def __init__(
+        self,
+        access_token: Optional[str] = None,
+        base_url: str = "https://api.fabric.microsoft.com/v1",
+        env_file: str = ".env",
+        interactive_login: bool = False,
+        tenant_id: Optional[str] = None,
+        client_id: Optional[str] = None,
+        redirect_uri: str = "http://localhost"
+    ):
+        """
+        Initialize Fabric client
+        
+        Args:
+            access_token: Bearer token for authentication (optional, will be acquired from .env if not provided)
+            base_url: Base URL for Fabric API (default: https://api.fabric.microsoft.com/v1)
+            env_file: Path to .env file for authentication (default: ".env")
+            interactive_login: Use interactive login flow if no access token provided
+            tenant_id: Azure AD tenant ID for interactive login (optional)
+            client_id: Azure AD app client ID for interactive login (optional)
+            redirect_uri: Redirect URI for interactive login (default: http://localhost)
+        """
+        # If no access token provided, get one from .env credentials
+        if access_token is None:
+            if interactive_login:
+                access_token = get_fabric_token_interactive(
+                    env_file=env_file,
+                    tenant_id=tenant_id,
+                    client_id=client_id,
+                    redirect_uri=redirect_uri
+                )
+            else:
+                access_token = get_fabric_token(env_file)
+        
+        self.config = FabricConfig(base_url=base_url, access_token=access_token)
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/json"
+        })
+    
+    def _make_request(
+        self,
+        method: str,
+        endpoint: str,
+        data: Optional[Dict[str, Any]] = None,
+        params: Optional[Dict[str, Any]] = None
+    ) -> requests.Response:
+        """
+        Make HTTP request to Fabric API
+        
+        Args:
+            method: HTTP method (GET, POST, PUT, DELETE, PATCH)
+            endpoint: API endpoint path
+            data: Request body data
+            params: Query parameters
+            
+        Returns:
+            Response object
+        """
+        url = f"{self.config.base_url}/{endpoint.lstrip('/')}"
+        
+        response = self.session.request(
+            method=method,
+            url=url,
+            json=data,
+            params=params
+        )
+        
+        # Raise exception for error status codes
+        response.raise_for_status()
+        
+        return response
+

fabricpandas/bulks/__init__.py

@@ -0,0 +1,8 @@
+"""
+Bulk operations module for FabricPandas
+"""
+
+from .bulk_client import BulkClient
+
+__all__ = ["BulkClient"]
+