pyegeria 5.2.0.8__tar.gz → 5.2.0.9__tar.gz

{pyegeria-5.2.0.8 → pyegeria-5.2.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyegeria
-Version: 5.2.0.8
+Version: 5.2.0.9
 Summary: A python client for Egeria
 Home-page: https://github.com/odpi/egeria-python
 License: Apache 2.0

{pyegeria-5.2.0.8 → pyegeria-5.2.0.9}/pyegeria/metadata_explorer_omvs.py

@@ -208,6 +208,7 @@ class MetadataExplorer(Client):
         self,
         guid: str,
         effective_time: str = None,
+        as_of_time: str = None,
         for_lineage: bool = None,
         for_duplicate_processing: bool = None,
     ) -> dict | str:
@@ -220,6 +221,8 @@ class MetadataExplorer(Client):
             - unique identifier of the element to retrieve
         effective_time: str, default = None
             - Time format is "YYYY-MM-DDTHH:MM:SS" (ISO 8601)
+        as_of_time: str, default = None
+            - Query the element as of this time. If None, then use current time.
         for_lineage: bool, default is set by server
             - determines if elements classified as Memento should be returned - normally false
         for_duplicate_processing: bool, default is set by server
@@ -248,8 +251,9 @@ class MetadataExplorer(Client):
         )
 
         body = {
-            "class": "EffectiveTimeRequestBody",
+            "class": "AnyTimeRequestBody",
             "effectiveTime": effective_time,
+            "asOfTime": as_of_time,
         }
 
         url = (
@@ -265,6 +269,7 @@ class MetadataExplorer(Client):
         self,
         guid: str,
         effective_time: str = None,
+        as_of_time: str = None,
         for_lineage: bool = None,
         for_duplicate_processing: bool = None,
     ) -> dict | str:
@@ -277,6 +282,8 @@ class MetadataExplorer(Client):
             - unique identifier of the element to retrieve
         effective_time: str, default = None
             - Time format is "YYYY-MM-DDTHH:MM:SS" (ISO 8601)
+        as_of_time: str, default = None
+            - Query the element as of this time. If None, then use current time.
         for_lineage: bool, default is set by server
             - determines if elements classified as Memento should be returned - normally false
         for_duplicate_processing: bool, default is set by server
@@ -305,6 +312,158 @@ class MetadataExplorer(Client):
         )
         return response
 
+    async def _async_get_metadata_element_graph(
+        self,
+        guid: str,
+        effective_time: str = None,
+        as_of_time: str = None,
+        for_lineage: bool = None,
+        for_duplicate_processing: bool = None,
+    ) -> dict | str:
+        """
+        Retrieve the metadata element and all of its anchored elements using its unique identifier. Async version.
+
+        Parameters
+        ----------
+        guid : str
+            - unique identifier of the element to retrieve
+        effective_time: str, default = None
+            - Time format is "YYYY-MM-DDTHH:MM:SS" (ISO 8601)
+        as_of_time: str, default = None
+            - Query the element as of this time. If None, then use current time.
+        for_lineage: bool, default is set by server
+            - determines if elements classified as Memento should be returned - normally false
+        for_duplicate_processing: bool, default is set by server
+            - Normally false. Set true when the caller is part of a deduplication function
+
+        Returns
+        -------
+        dict | str
+            If the element is found, a dict of the element details is returned. Otherwise the string "No element found".
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+        """
+
+        possible_query_params = query_string(
+            [
+                ("forLineage", for_lineage),
+                ("forDuplicateProcessing", for_duplicate_processing),
+            ]
+        )
+
+        body = {
+            "class": "AnyTimeRequestBody",
+            "effectiveTime": effective_time,
+            "asOfTime": as_of_time,
+        }
+
+        url = (
+            f"{base_path(self, self.view_server)}/metadata-elements/{guid}/with-anchored-elements"
+            f"{possible_query_params}"
+        )
+        response: Response = await self._async_make_request(
+            "POST", url, body_slimmer(body)
+        )
+        return response.json().get("elementGraph", "No elements found")
+
+    def get_metadata_element_graph(
+        self,
+        guid: str,
+        effective_time: str = None,
+        as_of_time: str = None,
+        for_lineage: bool = None,
+        for_duplicate_processing: bool = None,
+    ) -> dict | str:
+        """
+        Retrieve the metadata element using its unique identifier.
+
+        Parameters
+        ----------
+        guid : str
+            - unique identifier of the element to retrieve
+        effective_time: str, default = None
+            - Time format is "YYYY-MM-DDTHH:MM:SS" (ISO 8601)
+        as_of_time: str, default = None
+            - Query the element as of this time. If None, then use current time.
+        for_lineage: bool, default is set by server
+            - determines if elements classified as Memento should be returned - normally false
+        for_duplicate_processing: bool, default is set by server
+            - Normally false. Set true when the caller is part of a deduplication function
+
+        Returns
+        -------
+        dict | str
+            If the element is found, a dict of the element details is returned. Otherwise the string "No element found".
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+        """
+
+        loop = asyncio.get_event_loop()
+        response = loop.run_until_complete(
+            self._async_get_metadata_element_graph(
+                guid, effective_time, as_of_time, for_lineage, for_duplicate_processing
+            )
+        )
+        return response
+
+    def get_metadata_element_mermaid_graph(
+        self,
+        guid: str,
+        effective_time: str = None,
+        as_of_time: str = None,
+        for_lineage: bool = None,
+        for_duplicate_processing: bool = None,
+    ) -> dict | str:
+        """
+        Retrieve the metadata element using its unique identifier.
+
+        Parameters
+        ----------
+        guid : str
+            - unique identifier of the element to retrieve
+        effective_time: str, default = None
+            - Time format is "YYYY-MM-DDTHH:MM:SS" (ISO 8601)
+        as_of_time: str, default = None
+            - Query the element as of this time. If None, then use current time.
+        for_lineage: bool, default is set by server
+            - determines if elements classified as Memento should be returned - normally false
+        for_duplicate_processing: bool, default is set by server
+            - Normally false. Set true when the caller is part of a deduplication function
+
+        Returns
+        -------
+        dict | str
+            If the element is found, a dict of the element details is returned. Otherwise the string "No element found".
+
+        Raises
+        ------
+        InvalidParameterException
+            one of the parameters is null or invalid or
+        PropertyServerException
+            There is a problem adding the element properties to the metadata repository or
+        UserNotAuthorizedException
+            the requesting user is not authorized to issue this request.
+        """
+
+        response = self.get_metadata_element_graph(
+            guid, effective_time, as_of_time, for_lineage, for_duplicate_processing
+        )
+        return response.get("mermaidGraph", "No elements found")
+
     async def _async_get_metadata_element_by_unique_name(
         self,
         name: str,
@@ -1828,6 +1987,7 @@ class MetadataExplorer(Client):
         self,
         guid: str,
         effective_time: str = None,
+        as_of_time: str = None,
         for_lineage: bool = None,
         for_duplicate_processing: bool = None,
     ) -> dict | str:
@@ -1868,8 +2028,9 @@ class MetadataExplorer(Client):
         )
 
         body = {
-            "class": "EffectiveTimeRequestBody",
+            "class": "AnyTimeRequestBody",
             "effectiveTime": effective_time,
+            "asOfTime": as_of_time,
         }
 
         url = (

{pyegeria-5.2.0.8 → pyegeria-5.2.0.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyegeria"
-version = "5.2.0.8"
+version = "5.2.0.9"
 license = 'Apache 2.0'
 authors = ["Dan Wolfson <dan.wolfson@pdr-associates.com>"]
 readme = "README.md"