wandelbots-api-client 25.7.2rc2__tar.gz → 25.8.0__tar.gz

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/PKG-INFO

@@ -1,41 +1,40 @@
-Metadata-Version: 2.1
-Name: wandelbots-api-client
-Version: 25.7.2rc2
+Metadata-Version: 2.4
+Name: wandelbots_api_client
+Version: 25.8.0
 Summary: Wandelbots Python Client: Interact with robots in an easy and intuitive way. 
-Home-page: https://wandelbots.com/
-License: Apache-2.0
+Home-page: 
 Author: Copyright (c) 2025 Wandelbots GmbH
-Author-email: contact@wandelbots.com
-Requires-Python: >=3.9,<4.0
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: MacOS
+Author-email: "Copyright (c) 2025 Wandelbots GmbH" <contact@wandelbots.com>
+License-Expression: Apache-2.0
+Project-URL: homepage, https://wandelbots.com/
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: Software Development
-Classifier: Typing :: Typed
-Requires-Dist: aiohttp (>=3.8.4)
-Requires-Dist: aiohttp-retry (>=2.8.3)
-Requires-Dist: annotated-types
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+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: pydantic (>=2)
-Requires-Dist: pydantic_core
 Requires-Dist: pyhumps
-Requires-Dist: python-dateutil (>=2.8.2)
-Requires-Dist: typing-extensions (>=4.7.1)
-Requires-Dist: urllib3 (>=1.25.3)
-Requires-Dist: websockets
-Description-Content-Type: text/markdown
+Requires-Dist: pydantic_core
+Requires-Dist: annotated-types
+Dynamic: author
+Dynamic: license-file
 
 # wandelbots-api-client
 Interact with robots in an easy and intuitive way.
 
 - Compatible API version: 1.0.0 (can be found at the home screen of your instance -> API)
-- Package version: 25.7.2rc2
+- Package version: 25.8.0
 
 Sign up for our [Wandelbots Developers Beta program](https://www.wandelbots.com/developers-beta) to get access to the Wandelbots API.
 
@@ -60,4 +59,3 @@ wandelbots-api-client = "*"
 ```
 
 
-

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/README.md

@@ -2,7 +2,7 @@
 Interact with robots in an easy and intuitive way.
 
 - Compatible API version: 1.0.0 (can be found at the home screen of your instance -> API)
-- Package version: 25.7.2rc2
+- Package version: 25.8.0
 
 Sign up for our [Wandelbots Developers Beta program](https://www.wandelbots.com/developers-beta) to get access to the Wandelbots API.
 

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/pyproject.toml

@@ -1,12 +1,11 @@
-[tool.poetry]
+[project]
 name = "wandelbots_api_client"
-version = "25.7.2rc2"
+version = "25.8.0"
 description = "Wandelbots Python Client: Interact with robots in an easy and intuitive way. "
-authors = ["Copyright (c) 2025 Wandelbots GmbH <contact@wandelbots.com>"]
+authors = [{ name="Copyright (c) 2025 Wandelbots GmbH", email="contact@wandelbots.com" }]
 license = "Apache-2.0"
 readme = "README.md"
-homepage = "https://wandelbots.com/"
-include = ["wandelbots_api_client/py.typed"]
+urls = { homepage = "https://wandelbots.com/" }
 
 classifiers = [
     'Typing :: Typed',
@@ -17,22 +16,26 @@ classifiers = [
     'Operating System :: MacOS',
 ]
 
-[tool.poetry.dependencies]
-python = ">=3.9,<4.0"
+requires-python = ">=3.9"
 
-urllib3 = ">= 1.25.3"
-python-dateutil = ">=2.8.2"
-aiohttp = ">= 3.8.4"
-aiohttp-retry = ">= 2.8.3"
-pydantic = ">=2"
-websockets = "*"
-typing-extensions = ">=4.7.1"
-furl = "*"
-pyhumps = "*"
-pydantic_core = "*"
-annotated-types = "*"
+dependencies = [
+  "urllib3 >= 1.25.3",
+  "python-dateutil >=2.8.2",
+  "aiohttp >= 3.8.4",
+  "aiohttp-retry >= 2.8.3",
+  "pydantic >=2",
+  "websockets",
+  "typing-extensions >=4.7.1",
+  "furl",
+  "pyhumps",
+  "pydantic_core",
+  "annotated-types",
+]
+
+[tool.setuptools.package-data]
+wandelbots_api_client = ["py.typed"]
 
-[tool.poetry.dev-dependencies]
+[tool.poetry.group.dev.dependencies]
 pytest = ">=7.2.1"
 tox = ">=3.9.0"
 flake8 = ">=4.0.0"

wandelbots_api_client-25.8.0/setup.cfg

@@ -0,0 +1,7 @@
+[flake8]
+max-line-length = 99
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

wandelbots_api_client-25.8.0/setup.py

@@ -0,0 +1,52 @@
+# coding: utf-8
+
+"""
+    Wandelbots NOVA API
+
+    Interact with robots in an easy and intuitive way. 
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from setuptools import setup, find_packages  # noqa: H301
+
+# To install the library, run the following
+#
+# python setup.py install
+#
+# prerequisite: setuptools
+# http://pypi.python.org/pypi/setuptools
+NAME = "wandelbots-api-client"
+VERSION = "25.8.0"
+PYTHON_REQUIRES = ">= 3.8"
+REQUIRES = [
+    "urllib3 >= 1.25.3, < 3.0.0",
+    "python-dateutil >= 2.8.2",
+    "aiohttp >= 3.8.4",
+    "aiohttp-retry >= 2.8.3",
+    "pydantic >= 2",
+    "typing-extensions >= 4.7.1",
+]
+
+setup(
+    name=NAME,
+    version=VERSION,
+    description="Wandelbots NOVA API",
+    author="Copyright (c) 2025 Wandelbots GmbH",
+    author_email="team@openapitools.org",
+    url="",
+    keywords=["OpenAPI", "OpenAPI-Generator", "Wandelbots NOVA API"],
+    install_requires=REQUIRES,
+    packages=find_packages(exclude=["test", "tests"]),
+    include_package_data=True,
+    license="Apache 2.0",
+    long_description_content_type='text/markdown',
+    long_description="""\
+    Interact with robots in an easy and intuitive way. 
+    """,  # noqa: E501
+    package_data={"wandelbots_api_client": ["py.typed"]},
+)

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/wandelbots_api_client/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "25.7.2rc2"
+__version__ = "25.8.0"
 
 from . import models
 from . import api

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/wandelbots_api_client/api/virtual_robot_setup_api.py

@@ -68,7 +68,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -143,7 +143,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -218,7 +218,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -370,7 +370,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -449,7 +449,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -528,7 +528,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -686,7 +686,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -765,7 +765,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -844,7 +844,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -991,7 +991,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -1070,7 +1070,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -1149,7 +1149,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2143,7 +2143,7 @@ class VirtualRobotSetupApi:
     ) -> CoordinateSystem:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2222,7 +2222,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[CoordinateSystem]:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2301,7 +2301,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/wandelbots_api_client/api_client.py

@@ -90,7 +90,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/25.7.2rc2'
+        self.user_agent = 'Wandelbots-Nova-API-Python-Client/25.8.0'
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):

wandelbots_api_client-25.8.0/wandelbots_api_client/authorization.py

@@ -0,0 +1,244 @@
+from typing import Optional
+
+import asyncio
+import aiohttp
+import pydantic
+
+class Auth0Config(pydantic.BaseModel):
+    """Configuration for Auth0 authentication"""
+
+    domain: Optional[str] = None
+    client_id: Optional[str] = None
+    audience: Optional[str] = None
+
+    @classmethod
+    def default(cls) -> "Auth0Config":
+        """Create Auth0Config from environment variables"""
+        return cls(
+            domain="auth.portal.wandelbots.io",
+            client_id="J7WJUi38xVQdJAEBNRT9Xw1b0fXDb4J2",
+            audience="nova-api",
+        )
+
+    def is_complete(self) -> bool:
+        """Check if all required fields are set and not None"""
+        return bool(self.domain and self.client_id and self.audience)
+
+    def get_validated_config(self) -> tuple[str, str, str]:
+        """Get validated config values, ensuring they are not None"""
+        if not self.is_complete():
+            raise ValueError("Auth0 configuration is incomplete")
+        return self.domain, self.client_id, self.audience
+
+
+class Auth0DeviceCodeInfo(pydantic.BaseModel):
+    """
+    Model to store device code information.
+
+    Attributes:
+        device_code (str): The device code.
+        user_code (str): The user code.
+        verification_uri (str): The verification URI.
+        expires_in (int): The expiration time in seconds.
+        interval (int): The interval time in seconds (default is 5).
+    """
+
+    device_code: str
+    user_code: str
+    verification_uri: str
+    expires_in: int
+    interval: int = pydantic.Field(default=5)
+
+
+class Auth0TokenInfo(pydantic.BaseModel):
+    """
+    Model to store token information.
+
+    Attributes:
+        access_token (str): The access token.
+        refresh_token (str, optional): The refresh token.
+    """
+
+    access_token: str
+    refresh_token: Optional[str] = None
+
+
+class Auth0DeviceAuthorization:
+    """
+    Class to handle Auth0 device authorization.
+
+    Methods:
+        __init__(auth0_config: Auth0Config | None = None):
+            Initializes the Auth0DeviceAuthorization instance with the given parameters.
+        request_device_code():
+            Requests a device code from Auth0.
+        display_user_instructions():
+            Displays instructions for the user to authenticate.
+        poll_token_endpoint():
+            Polls the token endpoint to obtain an access token.
+        refresh_access_token(refresh_token: str):
+            Refreshes the access token using the refresh token.
+    """
+
+    def __init__(self, auth0_config: Optional[Auth0Config] = None):
+        """
+        Initialize with Auth0Config from env vars or passed config.
+
+        Args:
+            auth0_config: Optional Auth0Config object. If not provided,
+                         will be created using default configuration.
+        """
+        try:
+            self.params = auth0_config or Auth0Config.default()
+            if not self.params.is_complete():
+                raise ValueError("Auth0 configuration is incomplete")
+
+            domain, client_id, audience = self.params.get_validated_config()
+            self.auth0_domain = domain
+            self.auth0_client_id = client_id
+            self.auth0_audience = audience
+
+        except ValueError as e:
+            raise ValueError(f"Error: Auth0 configuration is invalid: {e}")
+
+        self.headers = {"content-type": "application/x-www-form-urlencoded"}
+        self.device_code_info: Optional[Auth0DeviceCodeInfo] = None
+        self.refresh_token: Optional[str] = None
+        self.interval = 5
+        self.attempts = 10
+
+    async def request_device_code(self) -> Auth0DeviceCodeInfo:
+        """
+        Requests a device code from Auth0.
+
+        Returns:
+            Auth0DeviceCodeInfo: The device code information.
+
+        Raises:
+            Exception: If there is an error requesting the device code.
+        """
+        device_code_url = f"https://{self.auth0_domain}/oauth/device/code"
+        data = {
+            "client_id": self.auth0_client_id,
+            "scope": "openid profile email",
+            "audience": self.auth0_audience,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(device_code_url, headers=self.headers, data=data) as response:
+                if response.status == 200:
+                    response_data = await response.json()
+                    self.device_code_info = Auth0DeviceCodeInfo(**response_data)
+                    self.interval = self.device_code_info.interval
+                    return self.device_code_info
+                else:
+                    error_data = await response.json()
+                    raise Exception("Error requesting device code:", error_data)
+
+    def get_device_code_info(self) -> Optional[Auth0DeviceCodeInfo]:
+        """
+        Returns the device code information.
+
+        Returns:
+            Optional[Auth0DeviceCodeInfo]: The device code information.
+        """
+        return self.device_code_info
+
+    def display_user_instructions(self) -> None:
+        """
+        Displays instructions for the user to authenticate.
+
+        Raises:
+            Exception: If device code information is not available.
+        """
+        if self.device_code_info:
+            verification_uri = f"{self.device_code_info.verification_uri}?user_code={self.device_code_info.user_code}"
+            user_code = self.device_code_info.user_code
+            print(
+                f"Please visit {verification_uri} and validate the code {user_code} to authenticate."
+            )
+        else:
+            raise Exception("Device code information is not available.")
+
+    async def poll_token_endpoint(self):
+        """
+        Polls the token endpoint to obtain an access token.
+
+        Returns:
+            str: The access token.
+
+        Raises:
+            Exception: If there is an error polling the token endpoint.
+        """
+        if not self.device_code_info:
+            raise Exception("Device code information is not available.")
+
+        token_url = f"https://{self.auth0_domain}/oauth/token"
+        token_data = {
+            "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+            "device_code": self.device_code_info.device_code,
+            "client_id": self.auth0_client_id,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            while self.attempts > 0:
+                self.attempts = self.attempts - 1
+                async with session.post(token_url, headers=self.headers, data=token_data) as token_response:
+                    if token_response.status == 200:
+                        # If the response status is 200, it means the access token is successfully obtained.
+                        response_data = await token_response.json()
+                        token_info = Auth0TokenInfo(**response_data)
+                        self.refresh_token = token_info.refresh_token
+                        return token_info.access_token
+                    elif token_response.status == 400:
+                        # If the response status is 400, check the error type.
+                        error_data = await token_response.json()
+                        error = error_data.get("error")
+                        if error == "authorization_pending":
+                            # If the error is 'authorization_pending', it means the user has not yet authorized.
+                            await asyncio.sleep(self.interval)
+                        elif error == "slow_down":
+                            # If the error is 'slow_down', it means the server requests to slow down polling.
+                            self.interval += 5
+                            await asyncio.sleep(self.interval)
+                    elif token_response.status == 403:
+                        # If the response status is 403, it means the request is forbidden, wait and retry.
+                        await asyncio.sleep(self.interval)
+                    else:
+                        # For other status codes, raise an exception with the error details.
+                        error_data = await token_response.json()
+                        raise Exception("Error:", token_response.status, error_data)
+        raise Exception("Error: It was not able to authenticate. Please try again.")
+
+    async def refresh_access_token(self, refresh_token: str):
+        """
+        Refreshes the access token using the refresh token.
+
+        Args:
+            refresh_token (str): The refresh token.
+
+        Returns:
+            str: The new access token.
+
+        Raises:
+            Exception: If there is an error refreshing the access token.
+        """
+        if not refresh_token:
+            raise Exception("Refresh token is not available.")
+
+        token_url = f"https://{self.auth0_domain}/oauth/token"
+        token_data = {
+            "grant_type": "refresh_token",
+            "client_id": self.auth0_client_id,
+            "refresh_token": refresh_token,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(token_url, headers=self.headers, data=token_data) as response:
+                if response.status == 200:
+                    response_data = await response.json()
+                    token_info = Auth0TokenInfo(**response_data)
+                    return token_info.access_token
+                else:
+                    error_data = await response.json()
+                    raise Exception("Error refreshing access token:", error_data)

{wandelbots_api_client-25.7.2rc2 → wandelbots_api_client-25.8.0}/wandelbots_api_client/configuration.py

@@ -524,7 +524,7 @@ conf = wandelbots_api_client.Configuration(
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 25.7.2rc2".\
+               "SDK Package Version: 25.8.0".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]: