pyegeria 5.2.1__py3-none-any.whl → 5.3__py3-none-any.whl

pyegeria/classification_manager_omvs.py

@@ -9,11 +9,11 @@ import asyncio
 
 from httpx import Response
 
-from pyegeria import body_slimmer
+from pyegeria.utils import body_slimmer
 
 # import json
 from pyegeria._client import Client, max_paging_size
-from pyegeria._globals import default_time_out
+from pyegeria._globals import default_time_out, NO_ELEMENTS_FOUND
 
 
 def query_seperator(current_string):
@@ -70,7 +70,9 @@ class ClassificationManager(Client):
         self.platform_url = platform_url
         self.user_id = user_id
         self.user_pwd = user_pwd
-        self.classification_command_root: str = f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/classification-manager"
+        self.classification_command_root: str = (
+            f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/classification-manager"
+        )
         Client.__init__(
             self,
             view_server,
@@ -153,10 +155,10 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_elements(
@@ -302,10 +304,10 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_elements_by_property_value(
@@ -460,10 +462,10 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def find_elements_by_property_value(
@@ -600,7 +602,7 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        elements = response.json().get("element", "No elements found")
+        elements = response.json().get("element", NO_ELEMENTS_FOUND)
 
         return elements
 
@@ -738,7 +740,7 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        return response.json().get("element", "No elements found")
+        return response.json().get("element", NO_ELEMENTS_FOUND)
 
     def get_element_by_unique_name(
         self,
@@ -802,7 +804,7 @@ class ClassificationManager(Client):
     async def _async_get_element_guid_by_unique_name(
         self,
         name: str,
-        property_name: str = None,
+        property_name: str = "qualifiedName",
         for_lineage: bool = False,
         for_duplicate_processing: bool = False,
         effective_time: str = None,
@@ -816,7 +818,7 @@ class ClassificationManager(Client):
         ----------
         name: str
             - element name to be searched.
-        property_name: str, optional
+        property_name: str, optional, default = "qualifiedName"
             - optional name of property to search. If not specified, defaults to qualifiedName
         for_lineage: bool, default is set by server
             - determines if elements classified as Memento should be returned - normally false
@@ -868,12 +870,12 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        return response.json().get("guid", "No elements found")
+        return response.json().get("guid", NO_ELEMENTS_FOUND)
 
     def get_element_guid_by_unique_name(
         self,
         name: str,
-        property_name: str = None,
+        property_name: str = "qualifiedName",
         for_lineage: bool = None,
         for_duplicate_processing: bool = None,
         effective_time: str = None,
@@ -887,7 +889,7 @@ class ClassificationManager(Client):
         ----------
         name: str
             - element name to be searched.
-        property_name: str, optional
+        property_name: str, optional, default = "qualifiedName"
             - optional name of property to search. If not specified, defaults to qualifiedName
         for_lineage: bool, default is set by server
             - determines if elements classified as Memento should be returned - normally false
@@ -966,7 +968,7 @@ class ClassificationManager(Client):
 
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
             elif len(elements) > 1:
                 raise Exception("Multiple elements found for supplied name!")
             elif len(elements) == 1:
@@ -1088,10 +1090,10 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def find_elements_by_property_value(
@@ -1246,10 +1248,10 @@ class ClassificationManager(Client):
         response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_elements_by_classification(
@@ -1405,10 +1407,10 @@ class ClassificationManager(Client):
         response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_elements_by_classification_with_property_value(
@@ -1547,6 +1549,8 @@ class ClassificationManager(Client):
         UserNotAuthorizedException
             the requesting user is not authorized to issue this request.
         """
+        if property_value == "*":
+            property_value = None
 
         possible_query_params = query_string(
             [
@@ -1572,10 +1576,10 @@ class ClassificationManager(Client):
         response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def find_elements_by_classification_with_property_value(
@@ -1751,10 +1755,10 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_related_elements(
@@ -1927,10 +1931,10 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def get_related_elements_with_property_value(
@@ -2113,10 +2117,10 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        elements = response.json().get("elements", "No elements found")
+        elements = response.json().get("elements", NO_ELEMENTS_FOUND)
         if type(elements) is list:
             if len(elements) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return elements
 
     def find_related_elements_with_property_value(
@@ -2278,7 +2282,7 @@ class ClassificationManager(Client):
 
         if type(rels) is list:
             if len(rels) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return rels
 
     def get_relationships(
@@ -2422,10 +2426,10 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        rels = response.json().get("relationships", "No elements found")
+        rels = response.json().get("relationships", NO_ELEMENTS_FOUND)
         if type(rels) is list:
             if len(rels) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return rels
 
     def get_relationships_with_property_value(
@@ -2578,10 +2582,10 @@ class ClassificationManager(Client):
             "POST", url, body_slimmer(body), time_out=time_out
         )
 
-        rels = response.json().get("relationships", "No elements found")
+        rels = response.json().get("relationships", NO_ELEMENTS_FOUND)
         if type(rels) is list:
             if len(rels) == 0:
-                return "No elements found"
+                return NO_ELEMENTS_FOUND
         return rels
 
     def find_relationships_with_property_value(
@@ -2719,7 +2723,7 @@ class ClassificationManager(Client):
         response: Response = await self._async_make_request(
             "POST", url, body_slimmer(body), time_out=time_out
         )
-        element = response.json().get("element", "No elements found")
+        element = response.json().get("element", NO_ELEMENTS_FOUND)
         return element
 
     def retrieve_instance_for_guid(