wandelbots_api_client 26.6.0.dev44__tar.gz → 26.6.0.dev45__tar.gz

wandelbots_api_client-26.6.0.dev45/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: wandelbots_api_client
+Version: 26.6.0.dev45
+Summary: Wandelbots Python Client: Interact with robots in an easy and intuitive way. 
+Author: Copyright (c) 2025 Wandelbots GmbH
+Author-email: Copyright (c) 2025 Wandelbots GmbH <contact@wandelbots.com>
+License-Expression: Apache-2.0
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Requires-Dist: urllib3>=1.25.3
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: aiohttp>=3.8.4
+Requires-Dist: aiohttp-retry>=2.8.3
+Requires-Dist: pydantic>=2
+Requires-Dist: websockets
+Requires-Dist: typing-extensions>=4.7.1
+Requires-Dist: furl
+Requires-Dist: pyhumps
+Requires-Dist: pydantic-core
+Requires-Dist: annotated-types
+Requires-Dist: pydantic[email]
+Requires-Python: >=3.9
+Project-URL: homepage, https://wandelbots.com/
+Description-Content-Type: text/markdown
+
+# wandelbots-api-client.v2
+Interact with robots in an easy and intuitive way.
+
+- Compatible API version: 2.6.0 dev (can be found at the home screen of your instance -> API)
+- Package version: 26.6.0.dev45
+
+## Requirements.
+Python >=3.9, Python < 4.0
+
+## Installation
+```
+pip install wandelbots-api-client
+```
+
+OR
+
+pyproject.toml:
+```
+[tool.poetry.dependencies]
+wandelbots-api-client = "*"
+```
+
+

wandelbots_api_client-26.6.0.dev45/README.md

@@ -0,0 +1,23 @@
+# wandelbots-api-client.v2
+Interact with robots in an easy and intuitive way.
+
+- Compatible API version: 2.6.0 dev (can be found at the home screen of your instance -> API)
+- Package version: 26.6.0.dev45
+
+## Requirements.
+Python >=3.9, Python < 4.0
+
+## Installation
+```
+pip install wandelbots-api-client
+```
+
+OR
+
+pyproject.toml:
+```
+[tool.poetry.dependencies]
+wandelbots-api-client = "*"
+```
+
+

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wandelbots_api_client"
-version = "26.6.0.dev44"
+version = "26.6.0.dev45"
 description = "Wandelbots Python Client: Interact with robots in an easy and intuitive way. "
 authors = [{ name="Copyright (c) 2025 Wandelbots GmbH", email="contact@wandelbots.com" }]
 license = "Apache-2.0"

wandelbots_api_client-26.6.0.dev45/wandelbots_api_client/authorization.py

@@ -0,0 +1,238 @@
+"""OAuth2 Device Code Flow implementation for Auth0 and Entra ID."""
+
+import aiohttp
+import asyncio
+from typing import Any
+from abc import ABC, abstractmethod
+import pydantic
+
+
+class DeviceCodeFlowConfig(pydantic.BaseModel, ABC):
+    """Base class for OAuth2 device code flow authentication."""
+
+    scope: str = "openid profile email offline_access"
+
+    class Config:
+        arbitrary_types_allowed = True
+
+    @abstractmethod
+    def is_complete(self) -> bool:
+        """Check if all required fields are set."""
+        pass
+
+    @property
+    @abstractmethod
+    def token_endpoint(self) -> str:
+        """Get the token endpoint URL."""
+        pass
+
+    @property
+    @abstractmethod
+    def device_endpoint(self) -> str:
+        """Get the device code endpoint URL."""
+        pass
+
+    @abstractmethod
+    def _build_device_code_request(self) -> dict[str, str]:
+        """Build the device code request data."""
+        pass
+
+    async def request_device_code(self) -> dict[str, Any]:
+        """
+        Request device code from the authorization server.
+
+        Returns:
+            Device code response with verification_uri, user_code, etc.
+
+        Raises:
+            ValueError: If configuration is incomplete
+            Exception: If device code request fails
+        """
+        if not self.is_complete():
+            raise ValueError(f"{self.__class__.__name__} configuration is incomplete")
+
+        data = self._build_device_code_request()
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                self.device_endpoint,
+                data=data,
+                headers={"Content-Type": "application/x-www-form-urlencoded"},
+            ) as response:
+                if response.status != 200:
+                    error_text = await response.text()
+                    raise Exception(f"Device code request failed: {error_text}")
+
+                return await response.json()
+
+    async def poll_token_endpoint(self, device_code: str, interval: int = 5, expires_in: int = 900) -> dict[str, str]:
+        """
+        Poll the token endpoint until authorization is complete.
+
+        Args:
+            device_code: Device code from request_device_code
+            interval: Polling interval in seconds
+            expires_in: Expiration time in seconds
+
+        Returns:
+            Token response with access_token, refresh_token, etc.
+
+        Raises:
+            TimeoutError: If authorization times out
+            Exception: If authorization fails
+        """
+        start_time = asyncio.get_event_loop().time()
+
+        while (asyncio.get_event_loop().time() - start_time) < expires_in:
+            await asyncio.sleep(interval)
+
+            async with aiohttp.ClientSession() as session:
+                async with session.post(
+                    self.token_endpoint,
+                    data={
+                        "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+                        "device_code": device_code,
+                        "client_id": self._get_client_id(),
+                    },
+                    headers={"Content-Type": "application/x-www-form-urlencoded"},
+                ) as response:
+                    if response.status == 200:
+                        return await response.json()
+
+                    error_data = await response.json()
+                    error = error_data.get("error")
+
+                    if error == "authorization_pending":
+                        continue
+                    elif error == "slow_down":
+                        interval += 5
+                        continue
+                    else:
+                        raise Exception(f"Authorization failed: {error}")
+
+        raise TimeoutError("Device authorization timed out")
+
+    async def refresh_token(self, refresh_token: str) -> dict[str, str]:
+        """
+        Refresh access token using refresh token.
+
+        Args:
+            refresh_token: Refresh token from previous authentication
+
+        Returns:
+            New token response with access_token and potentially new refresh_token
+
+        Raises:
+            Exception: If token refresh fails
+        """
+        async with aiohttp.ClientSession() as session:
+            async with session.post(
+                self.token_endpoint,
+                data={
+                    "grant_type": "refresh_token",
+                    "refresh_token": refresh_token,
+                    "client_id": self._get_client_id(),
+                },
+                headers={"Content-Type": "application/x-www-form-urlencoded"},
+            ) as response:
+                if response.status != 200:
+                    error_text = await response.text()
+                    raise Exception(f"Token refresh failed: {error_text}")
+
+                return await response.json()
+
+    @abstractmethod
+    def _get_client_id(self) -> str:
+        """Get the client ID for the configuration."""
+        pass
+
+
+class Auth0Config(DeviceCodeFlowConfig):
+    """Configuration for Auth0 device code flow authentication."""
+
+    domain: str | None = None
+    client_id: str | None = None
+    audience: str | None = None
+
+    @classmethod
+    def default(cls) -> "Auth0Config":
+        """Provide the default Auth0 configuration."""
+        return cls(
+            domain="",
+            client_id="",
+            audience="",
+        )
+
+    def is_complete(self) -> bool:
+        """Check if all required fields are set."""
+        return bool(self.domain and self.client_id and self.audience)
+
+    @property
+    def token_endpoint(self) -> str:
+        """Get the token endpoint URL."""
+        if not self.domain:
+            raise ValueError("Domain is not set")
+        return f"https://{self.domain}/oauth/token"
+
+    @property
+    def device_endpoint(self) -> str:
+        """Get the device code endpoint URL."""
+        if not self.domain:
+            raise ValueError("Domain is not set")
+        return f"https://{self.domain}/oauth/device/code"
+
+    def _get_client_id(self) -> str:
+        """Get the client ID for the configuration."""
+        if not self.client_id:
+            raise ValueError("Client ID is not set")
+        return self.client_id
+
+    def _build_device_code_request(self) -> dict[str, str]:
+        """Build the device code request data."""
+        data = {
+            "client_id": self.client_id,
+            "scope": self.scope,
+        }
+        if self.audience:
+            data["audience"] = self.audience
+        return data
+
+
+class EntraIDConfig(DeviceCodeFlowConfig):
+    """Configuration for Microsoft Entra ID (Azure AD) device code flow authentication."""
+
+    client_id: str | None = None
+    tenant_id: str | None = None
+
+    def is_complete(self) -> bool:
+        """Check if all required fields are set."""
+        return bool(self.client_id and self.tenant_id)
+
+    @property
+    def token_endpoint(self) -> str:
+        """Get the token endpoint URL."""
+        if not self.tenant_id:
+            raise ValueError("Tenant ID is not set")
+        return f"https://login.microsoftonline.com/{self.tenant_id}/oauth2/v2.0/token"
+
+    @property
+    def device_endpoint(self) -> str:
+        """Get the device code endpoint URL."""
+        if not self.tenant_id:
+            raise ValueError("Tenant ID is not set")
+        return f"https://login.microsoftonline.com/{self.tenant_id}/oauth2/v2.0/devicecode"
+
+    def _get_client_id(self) -> str:
+        """Get the client ID for the configuration."""
+        if not self.client_id:
+            raise ValueError("Client ID is not set")
+        return self.client_id
+
+    def _build_device_code_request(self) -> dict[str, str]:
+        """Build the device code request data."""
+        if not self.client_id:
+            raise ValueError("Client ID is not set")
+        return {
+            "client_id": self.client_id,
+            "scope": self.scope,
+        }

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2/__init__.py

@@ -13,7 +13,7 @@ Generated by OpenAPI Generator (https://openapi-generator.tech)
 Do not edit the class manually.
 """  # noqa: E501
 
-__version__ = "26.6.0.dev44"
+__version__ = "26.6.0.dev45"
 
 from . import api
 from . import api_client

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2/api_client.py

@@ -85,7 +85,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.6.0.dev44"
+        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.6.0.dev45"
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2/configuration.py

@@ -512,7 +512,7 @@ class Configuration:
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 2.6.0 dev\n"
-            "SDK Package Version: 26.6.0.dev44".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 26.6.0.dev45".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self) -> List[HostSetting]:

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2_pydantic/__init__.py

@@ -13,7 +13,7 @@ Generated by OpenAPI Generator (https://openapi-generator.tech)
 Do not edit the class manually.
 """  # noqa: E501
 
-__version__ = "26.6.0.dev44"
+__version__ = "26.6.0.dev45"
 
 from . import api
 from . import api_client

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2_pydantic/api_client.py

@@ -85,7 +85,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.6.0.dev44"
+        self.user_agent = "Wandelbots-Nova-API-Python-Client/26.6.0.dev45"
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2_pydantic/configuration.py

@@ -512,7 +512,7 @@ class Configuration:
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 2.6.0 dev\n"
-            "SDK Package Version: 26.6.0.dev44".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 26.6.0.dev45".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self) -> List[HostSetting]:

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2_pydantic/models/__init__.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  tmppbly5qf4
-#   timestamp: 2026-06-30T12:30:50+00:00
+#   filename:  tmpr5wlf014
+#   timestamp: 2026-06-30T16:55:31+00:00
 
 from __future__ import annotations
 

{wandelbots_api_client-26.6.0.dev44 → wandelbots_api_client-26.6.0.dev45}/wandelbots_api_client/v2_pydantic/models/models.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  models.yaml
-#   timestamp: 2026-06-30T12:30:50+00:00
+#   timestamp: 2026-06-30T16:55:31+00:00
 
 from __future__ import annotations
 from pydantic import AnyUrl, AwareDatetime, BaseModel, EmailStr, Field, RootModel

wandelbots_api_client-26.6.0.dev44/PKG-INFO

@@ -1,241 +0,0 @@
-Metadata-Version: 2.4
-Name: wandelbots_api_client
-Version: 26.6.0.dev44
-Summary: Wandelbots Python Client: Interact with robots in an easy and intuitive way. 
-Author: Copyright (c) 2025 Wandelbots GmbH
-Author-email: Copyright (c) 2025 Wandelbots GmbH <contact@wandelbots.com>
-License-Expression: Apache-2.0
-Classifier: Typing :: Typed
-Classifier: Topic :: Software Development
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: Unix
-Classifier: Operating System :: MacOS
-Requires-Dist: urllib3>=1.25.3
-Requires-Dist: python-dateutil>=2.8.2
-Requires-Dist: aiohttp>=3.8.4
-Requires-Dist: aiohttp-retry>=2.8.3
-Requires-Dist: pydantic>=2
-Requires-Dist: websockets
-Requires-Dist: typing-extensions>=4.7.1
-Requires-Dist: furl
-Requires-Dist: pyhumps
-Requires-Dist: pydantic-core
-Requires-Dist: annotated-types
-Requires-Dist: pydantic[email]
-Requires-Python: >=3.9
-Project-URL: homepage, https://wandelbots.com/
-Description-Content-Type: text/markdown
-
-# wandelbots-api-client
-Interact with robots in an easy and intuitive way.
-
-- Compatible API version: 1.6.0 dev (can be found at the home screen of your instance -> API)
-- Package version: 26.6.0.dev44
-
-## Requirements.
-Python >=3.11, Python < 4.0
-
-## Installation
-
-```bash
-pip install wandelbots-api-client
-```
-
-OR with uv:
-
-```bash
-uv init
-uv add wandelbots-api-client
-```
-
-## Authentication
-
-The SDK supports OAuth2 device code flow authentication for both Entra ID (formerly Azure AD) and Auth0. This authentication method is ideal for CLI applications, scripts, and headless environments.
-
-### Entra ID (Azure AD) Authentication
-
-```python
-import asyncio
-from wandelbots_api_client import ApiClient, Configuration
-from wandelbots_api_client.authorization import EntraIDConfig
-
-async def main():
-    # Initialize Entra ID config
-    auth = EntraIDConfig(
-        client_id="GIVEN_CLIENT_ID",
-        tenant_id="GIVEN_TENANT_ID", 
-        scope="openid profile email offline_access GIVEN_CLIENT_ID\.default"
-    )
-    
-    # Request device code
-    device_response = await auth.request_device_code()
-    
-    # Display user instructions
-    print(f"\nPlease authenticate:")
-    print(f"1. Go to: {device_response['verification_uri']}")
-    print(f"2. Enter code: {device_response['user_code']}")
-    print(f"Waiting for authentication...\n")
-    
-    # Poll for token (will wait until user completes authentication)
-    token_response = await auth.poll_token_endpoint(
-        device_code=device_response["device_code"],
-        interval=device_response.get("interval", 5),
-        expires_in=device_response.get("expires_in", 900)
-    )
-    
-    print("Authentication successful!")
-    
-    # Configure API client with access token
-    config = Configuration(
-        host="https://your-instance.wandelbots.io",
-        access_token=token_response["access_token"]
-    )
-    
-    async with ApiClient(configuration=config) as api_client:
-        # Use the API client for authenticated requests
-        # Example: api = YourApi(api_client)
-        # result = await api.your_method()
-        pass
-    
-    # Optionally refresh the token later
-    if "refresh_token" in token_response:
-        new_token = await auth.refresh_token(token_response["refresh_token"])
-        config.access_token = new_token["access_token"]
-
-asyncio.run(main())
-```
-
-### Auth0 Authentication
-
-```python
-import asyncio
-from wandelbots_api_client import ApiClient, Configuration
-from wandelbots_api_client.authorization import Auth0Config
-
-async def main():
-    # Initialize Auth0 config
-    auth = Auth0Config(
-        client_id="GIVEN_CLIENT_ID",
-        domain="auth.portal.wandelbots.io",
-        audience="GIVEN_AUDIENCE", 
-        scope="openid profile email offline_access"
-    )
-    
-    # Or use default config from template variables
-    # auth = Auth0Config.default()
-    
-    # Request device code
-    device_response = await auth.request_device_code()
-    
-    # Display user instructions
-    print(f"\nPlease authenticate:")
-    print(f"1. Go to: {device_response['verification_uri']}")
-    print(f"2. Enter code: {device_response['user_code']}")
-    print(f"Waiting for authentication...\n")
-    
-    # Poll for token (will wait until user completes authentication)
-    token_response = await auth.poll_token_endpoint(
-        device_code=device_response["device_code"],
-        interval=device_response.get("interval", 5),
-        expires_in=device_response.get("expires_in", 900)
-    )
-    
-    print("Authentication successful!")
-    
-    # Configure API client with access token
-    config = Configuration(
-        host="https://XYZ.instances.wandelbots.io",
-        access_token=token_response["access_token"]
-    )
-    
-    async with ApiClient(configuration=config) as api_client:
-        # Use the API client for authenticated requests
-        # Example: api = YourApi(api_client)
-        # result = await api.your_method()
-        pass
-
-asyncio.run(main())
-```
-
-### Token Refresh
-
-To maintain long-lived sessions, use refresh tokens to obtain new access tokens:
-
-```python
-# When your access token expires
-if "refresh_token" in token_response:
-    refreshed = await auth.refresh_token(token_response["refresh_token"])
-    config.access_token = refreshed["access_token"]
-    
-    # Update refresh token if a new one is provided
-    if "refresh_token" in refreshed:
-        token_response["refresh_token"] = refreshed["refresh_token"]
-```
-
-### Complete Example with Error Handling
-
-```python
-import asyncio
-from wandelbots_api_client import ApiClient, Configuration
-from wandelbots_api_client.authorization import EntraIDConfig
-
-async def authenticate_and_call_api():
-    """Complete example with error handling."""
-    try:
-        # Initialize authentication
-        auth = EntraIDConfig(
-            client_id="GIVEN_CLIENT_ID",
-            tenant_id="GIVEN_TENANT_ID",
-            scopen="openid profile email offline_access GIVEN_CLIENT_ID\.default"
-        )
-        
-        # Verify configuration
-        if not auth.is_complete():
-            raise ValueError("Authentication configuration is incomplete")
-        
-        # Request device code
-        device_response = await auth.request_device_code()
-        
-        # Display instructions
-        print(f"\n{'='*60}")
-        print(f"AUTHENTICATION REQUIRED")
-        print(f"{'='*60}")
-        print(f"Visit: {device_response['verification_uri']}")
-        print(f"Enter code: {device_response['user_code']}")
-        print(f"{'='*60}\n")
-        
-        # Wait for user to authenticate
-        token_response = await auth.poll_token_endpoint(
-            device_code=device_response["device_code"],
-            interval=device_response.get("interval", 5),
-            expires_in=device_response.get("expires_in", 900)
-        )
-        
-        print("✓ Authentication successful!\n")
-        
-        # Create API client
-        config = Configuration(
-            host="https://XYZ.instance.wandelbots.io",
-            access_token=token_response["access_token"]
-        )
-        
-        async with ApiClient(configuration=config) as api_client:
-            # Make authenticated API calls here
-            # Example:
-            # from wandelbots_api_client.api import YourApi
-            # api = YourApi(api_client)
-            # result = await api.your_method()
-            print("API client ready for requests")
-            
-    except TimeoutError:
-        print("Authentication timed out. Please try again.")
-    except ValueError as e:
-        print(f"Configuration error: {e}")
-    except Exception as e:
-        print(f"Authentication failed: {e}")
-
-asyncio.run(authenticate_and_call_api())
-```
-
-