aas-http-client 1.2.3__tar.gz → 1.2.5__tar.gz

{aas_http_client-1.2.3 → aas_http_client-1.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aas-http-client
-Version: 1.2.3
+Version: 1.2.5
 Summary: Flexible Python HTTP client for communication with various types of AAS servers.
 Author-email: Daniel Klein <daniel.klein@em.ag>
 License: MIT License

{aas_http_client-1.2.3 → aas_http_client-1.2.5}/aas_http_client/classes/client/implementations/experimental_implementation.py

@@ -14,6 +14,7 @@ from pydantic import BaseModel
 from aas_http_client.utilities.encoder import encode_base_64
 from aas_http_client.utilities.http_helper import (
     STATUS_CODE_200,
+    STATUS_CODE_201,
     STATUS_CODE_204,
     STATUS_CODE_404,
     log_response,
@@ -32,11 +33,127 @@ class ExperimentalImplementation(BaseModel):
         session = client.get_session()
         if session is None:
             raise ValueError(
-                "HTTP session is not initialized in the client. Call 'initialize()' method of the client before creating SubmodelRegistryImplementation instance."
+                "HTTP session is not initialized in the client. Call 'initialize()' method of the client before creating ExperimentalImplementation instance."
             )
 
         self._session: requests.Session = session
 
+    # GET /concept-descriptions
+    def get_concept_descriptions(self):
+        """Retrieves concept descriptions. Experimental feature - may not be supported by all servers."""
+        url = f"{self._client.base_url}/concept-descriptions"
+
+        self._client.set_token()  # ensures Authorization header is set
+
+        try:
+            response = self._session.get(url, timeout=self._client.time_out)
+            _logger.debug(f"Call REST API url '{response.url}'")
+
+            if response.status_code == STATUS_CODE_404:
+                _logger.warning("Concept descriptions not found.")
+                _logger.debug(response.text)
+                return None
+
+            if response.status_code != STATUS_CODE_200:
+                log_response(response)
+                return None
+
+        except requests.exceptions.RequestException as e:
+            _logger.error(f"Error calling REST API: {e}")
+            return None
+
+        return response.json()
+
+    # GET /concept-descriptions/{conceptDescriptionIdentifier}
+    def get_concept_description_by_id(self, concept_description_identifier: str):
+        """Retrieves a specific concept description by its identifier. Experimental feature - may not be supported by all servers.
+
+        :param concept_description_identifier: The unique identifier of the concept description
+        :return: Concept description data as a dictionary or None if not found
+        """
+        url = f"{self._client.base_url}/concept-descriptions/{concept_description_identifier}"
+
+        self._client.set_token()  # ensures Authorization header is set
+
+        try:
+            response = self._session.get(url, timeout=self._client.time_out)
+            _logger.debug(f"Call REST API url '{response.url}'")
+
+            if response.status_code == STATUS_CODE_404:
+                _logger.warning(f"Concept description with id '{concept_description_identifier}' not found.")
+                _logger.debug(response.text)
+                return None
+
+            if response.status_code != STATUS_CODE_200:
+                log_response(response)
+                return None
+
+        except requests.exceptions.RequestException as e:
+            _logger.error(f"Error calling REST API: {e}")
+            return None
+
+        return response.json()
+
+    # POST /concept-descriptions
+    def post_concept_description(self, concept_description: dict) -> bool:
+        """Creates a new concept description. Experimental feature - may not be supported by all servers.
+
+        :param concept_description: Concept description data as a dictionary
+        :return: True if creation was successful, False otherwise
+        """
+        url = f"{self._client.base_url}/concept-descriptions"
+
+        self._client.set_token()  # ensures Authorization header is set
+
+        try:
+            response = self._session.post(url, json=concept_description, timeout=self._client.time_out)
+            _logger.debug(f"Call REST API url '{response.url}'")
+
+            if response.status_code == STATUS_CODE_404:
+                _logger.warning("Concept descriptions endpoint not found.")
+                _logger.debug(response.text)
+                return False
+
+            if response.status_code != STATUS_CODE_201:
+                log_response(response)
+                return False
+
+        except requests.exceptions.RequestException as e:
+            _logger.error(f"Error calling REST API: {e}")
+            return False
+
+        return True
+
+    # DELETE /concept-descriptions/{conceptDescriptionIdentifier}
+    def delete_concept_description_by_id(self, concept_description_identifier: str) -> bool:
+        """Deletes a specific concept description by its identifier. Experimental feature - may not be supported by all servers.
+
+        :param concept_description_identifier: The unique identifier of the concept description
+        :return: True if deletion was successful, False otherwise
+        """
+        url = f"{self._client.base_url}/concept-descriptions/{concept_description_identifier}"
+
+        self._client.set_token()  # ensures Authorization header is set
+
+        try:
+            response = self._session.delete(url, timeout=self._client.time_out)
+            _logger.debug(f"Call REST API url '{response.url}'")
+
+            if response.status_code == STATUS_CODE_404:
+                _logger.warning(f"Concept description with id '{concept_description_identifier}' not found.")
+                _logger.debug(response.text)
+                return False
+
+            if response.status_code != STATUS_CODE_204:
+                log_response(response)
+                return False
+
+        except requests.exceptions.RequestException as e:
+            _logger.error(f"Error calling REST API: {e}")
+            return False
+
+        return True
+
     # GET /submodels/{submodelIdentifier}/submodel-elements/{idShortPath}/attachment
     def get_file_by_path_submodel_repo(self, submodel_identifier: str, id_short_path: str) -> bytes | None:
         """Downloads file content from a specific submodel element from the Submodel at a specified path. Experimental feature - may not be supported by all servers.

{aas_http_client-1.2.3 → aas_http_client-1.2.5}/aas_http_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aas-http-client
-Version: 1.2.3
+Version: 1.2.5
 Summary: Flexible Python HTTP client for communication with various types of AAS servers.
 Author-email: Daniel Klein <daniel.klein@em.ag>
 License: MIT License

{aas_http_client-1.2.3 → aas_http_client-1.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aas-http-client"
-version = "1.2.3"
+version = "1.2.5"
 description = "Flexible Python HTTP client for communication with various types of AAS servers."
 readme = "README.md"
 license = { file = "LICENSE" }