pyegeria 5.3.9.9.7__py3-none-any.whl → 5.4.0__py3-none-any.whl

md_processing/md_processing_utils/md_processing_constants.py

@@ -1,19 +1,19 @@
 """
 This file contains display-related constants and formatting functions for Egeria Markdown processing
 """
+import importlib.resources
 import json
 import os
-import importlib.resources
+
 from rich.markdown import Markdown
 
+from md_processing.md_processing_utils.message_constants import ERROR
 from pyegeria._globals import DEBUG_LEVEL
 from md_processing.md_processing_utils.message_constants import message_types, ALWAYS, ERROR, INFO, WARNING
 
 EGERIA_ROOT_PATH = os.environ.get("EGERIA_ROOT_PATH", "/home/jovyan")
 EGERIA_INBOX_PATH = os.environ.get("EGERIA_INBOX_PATH", "loading-bay/dr_egeria_inbox")
 
-
-
 # Constants for element labels
 GLOSSARY_NAME_LABELS = ["Glossary Name", "Glossary", "Glossaries", "Owning Glossary", "In Glossary"]
 CATEGORY_NAME_LABELS = ["Glossary Category Name", "Glossary Category", "Glossary Categories", "Category Name",
@@ -43,18 +43,98 @@ ELEMENT_OUTPUT_FORMATS = ["LIST", "DICT", "MD", "FORM", "REPORT"]
 
 # Constants for term relationships
 TERM_RELATIONSHPS = ["Synonym", "Translation", "PreferredTerm", "TermISATYPEOFRelationship", "TermTYPEDBYRelationship",
-    "Antonym", "ReplacementTerm", "ValidValue", "TermHASARelationship", "RelatedTerm", "ISARelationship"]
+                     "Antonym", "ReplacementTerm", "ValidValue", "TermHASARelationship", "RelatedTerm",
+                     "ISARelationship"]
 
 # List of supported md_commands
+GOV_LINK_LIST = [ "Link Governance Drivers", "Detach Governance Drivers",
+                "Link Governance Policies", "Detach Governance Policies",
+                "Link Governance Controls", "Detach Governance Controls",]
+
+GOV_COM_LIST = [ "Create Business Imperative", "Update Business Imperative",
+                "Create Regulation Article Definition", "Update Regulation Article Definition",
+                "Create Threat Definition", "Update Threat Definition",
+                "Create Governance Principle", "Update Governance Principle",
+                "Create Governance Obligation", "Update Governance Obligation",
+                "Create Governance Approach", "Update Governance Approach",
+                "Create Governance Strategy", "Update Governance Strategy",
+                "Create Regulation", "Create Regulation Definition", "Update Regulation", "Update Regulation Definition",
+                "Create Governance Control:", "Update Governance Control",
+                "Create Governance Rule:", "Update Governance Rule",
+                "Create Service Level Objective", "Update Service Level Objective",
+                "Create Governance Process", "Update Governance Process",
+                "Create Governance Responsibility", "Update Governance Responsibility",
+                "Create Governance Procedure", "Update Governance Procedure",
+                "Create Security Access Control", "Update Security Access Control",
+                "Create Security Group", "Update Security Group",
+                "Create Naming Standard Rule", "Update Naming Standard Rule",
+                "Create Certification Type", "Update Certification Type",
+                "Create License Type", "Update License Type",]
+
 command_list = ["Provenance", "Create Glossary", "Update Glossary", "Create Term", "Update Term", "List Terms",
                 "List Term Details", "List Glossary Terms", "List Term History", "List Term Revision History",
                 "List Term Update History", "List Glossary Structure", "List Glossaries", "List Categories",
                 "List Glossary Categories", "Create Personal Project", "Update Personal Project", "Create Category",
-                "Update Category", "Create Solution Blueprint", "Update Solution Blueprint",
-                "Create Solution Component", "Update Solution Component", "Create Term-Term Relationship",
-                "Update Term-Term Relationship","Create Data Spec", "Create Data Specification", "Update Data Spec",
-                "Update Data Specification" , "Create Data Field", "Update Data Field", "Create Data Structure", "Update Data Structure",
-                "Create Data Dictionary", "Update Data Dictionary", "Create Data Dict", "Update Data Dict"," View Data Dictionary", "View Data Dictionaries"]
+                "Update Category", "Create Solution Blueprint", "Update Solution Blueprint", "View Solution Blueprint",
+                "View Solution Blueprints", "View Blueprints",
+                "View Information Supply Chain", "View Information Supply Chains", "View Supply Chains", "View Supply Chain",
+                "View Solution Components", "View Solution Component", "View Solution Roles", "View Solution Role",
+                "Create Information Supply Chain", "Update Information Supply Chain",
+                "Link Information Supply Chain Peers", "Link Supply Chains", "Link Information Supply Chains",
+                "Unlink Information Supply Chain Peers", "Unlink Information Supply Chains", "Unlink Supply Chains",
+                "Create Solution Component", "Update Solution Component", "Link Solution Components", "Wire Solution Components",
+                "Detach Solution Components", "Unlink Solution Components", "Create Term-Term Relationship",
+                "Update Term-Term Relationship", "Create Data Spec", "Create Data Specification", "Update Data Spec",
+                "Update Data Specification", "Create Data Field", "Update Data Field", "Create Data Structure",
+                "Update Data Structure", "Create Data Dictionary", "Update Data Dictionary", "Create Data Dict",
+                "Update Data Dict", " View Data Dictionary", "View Data Dictionaries", "View Data Specifications",
+                "View Data Specs", "View Data Structures", "View Data Structure", "View Data Fields", "View Data Field",
+                "View Dataa Classes", "View Data Class", "Create Data Class", "Update Data Class",
+                "Create Digital Product", "Create Data Product", "Update Digital Product", "Update Data Product",
+                "Create Agreement", "Update Agreement",
+                "Link Digital Products", "Link Data Products", "Detach Digital Products", "Detach Data Products",
+                "Create Data Sharing Agreement", "Update Data Sharing Agreement",
+                "Create Digital Subscription", "Create Product Subscription", "Update Digital Subscription", "Update Product Subscription",
+                "Attach Agreement Items", "Detach Agreement Items",
+                "Attach Contract", "Detach Contract",
+                "Attach Subscriber", "Detach Subscriber",
+                "Link Collection to Resource", "Attach Collection to Resource",
+                "Unlink Collection From Resource", "Detach Collection From Resource",
+                "Add Member to Collection", "Add Member", "Member->Collection",
+                "Remove Member from Collection","Remove Member from Collection",
+                "View Digital Products", "View Data Products", "List Data Products", "List Digtal Products",
+                "View Agreements", "View Data Sharing Agreements", "List Agreements", "List Data Sharing Agreements",
+                "View Subscriptions", "List Subscriptions", "View Governance Definitions", "View Gov Definitions",
+                 "List Governance Definitions", "List Gov Definitions",
+                "View Governance Definition Context","List Governance Definition Context",
+                "View Governance Def Context", "List Governance Def Context",
+                # "Create Business Imperative", "Update Business Imperative",
+                # "Create Regulation Article Definition", "Update Regulation Article Definition",
+                # "Create Threat Definition", "Update Threat Definition",
+                # "Create Governance Principle", "Update Governance Principle",
+                # "Create Governance Obligation", "Update Governance Obligation",
+                # "Create Governance Approach", "Update Governance Approach",
+                # "Create Governance Strategy", "Update Governance Strategy",
+                # "Create Regulation", "Create Regulation Definition", "Update Regulation", "Update Regulation Definition",
+                # "Create Governance Control:", "Update Governance Control",
+                # "Create Governance Rule:", "Update Governance Rule",
+                # "Create Service Level Objective", "Update Service Level Objective",
+                # "Create Governance Process", "Update Governance Process",
+                # "Create Governance Responsibility", "Update Governance Responsibility",
+                # "Create Governance Procedure", "Update Governance Procedure",
+                # "Create Security Access Control", "Update Security Access Control",
+                # "Create Security Group", "Update Security Group",
+                # "Create Naming Standard Rule", "Update Naming Standard Rule",
+                # "Create Certification Type", "Update Certification Type",
+                # "Create License Type", "Update License Type",
+                # "Link Governance Drivers", "Detach Governance Drivers",
+                # "Link Governance Policies", "Detach Governance Policies",
+                # "Link Governance Controls", "Detach Governance Controls",
+
+                ]
+
+command_list.extend(GOV_COM_LIST)
+command_list.extend(GOV_LINK_LIST)
 
 pre_command = "\n---\n==> Processing object_action:"
 command_seperator = Markdown("\n---\n")
@@ -64,21 +144,14 @@ COMMAND_DEFINITIONS = {}
 debug_level = DEBUG_LEVEL
 
 
-
 def load_commands(filename: str) -> None:
     global COMMAND_DEFINITIONS
-    # print("EGERIA_INBOX_PATH: ", EGERIA_INBOX_PATH)
-
-    # full_file_path = os.path.join(EGERIA_ROOT_PATH, EGERIA_INBOX_PATH, filename)
 
-    # print("Loading commands from: ", full_file_path)
     try:
         config_path = importlib.resources.files("md_processing") / "data" / filename
         config_str = config_path.read_text(encoding="utf-8")
         COMMAND_DEFINITIONS = json.loads(config_str)
 
-        # with open(full_file_path, 'r') as file:
-        #     COMMAND_DEFINITIONS = json.load(file)
     except FileNotFoundError:
         msg = f"ERROR: File {filename} not found."
         print(ERROR, msg, debug_level)
@@ -86,6 +159,7 @@ def load_commands(filename: str) -> None:
 
 def get_command_spec(command: str) -> dict | None:
     global COMMAND_DEFINITIONS
+
     com = COMMAND_DEFINITIONS.get('Command Specifications', {}).get(command, None)
     if com:
         return com
@@ -94,16 +168,19 @@ def get_command_spec(command: str) -> dict | None:
         if obj:
             return COMMAND_DEFINITIONS.get('Command Specifications', {}).get(obj, None)
 
+
 def find_alternate_names(command: str) -> str | None:
     global COMMAND_DEFINITIONS
+
     comm_spec = COMMAND_DEFINITIONS.get('Command Specifications', {})
     for key, value in comm_spec.items():
         if isinstance(value, dict):
-            v = value.get('alternate_names',"")
+            v = value.get('alternate_names', "")
             if command in v:
                 return key
     return None
 
+
 def get_alternate_names(command: str) -> list | None:
     global COMMAND_DEFINITIONS
     return get_command_spec(command).get('alternate_names', None)

pyegeria/__init__.py

@@ -43,6 +43,7 @@ from .feedback_manager_omvs import FeedbackManager
 from .full_omag_server_config import FullServerConfig
 from .glossary_browser_omvs import GlossaryBrowser
 from .glossary_manager_omvs import GlossaryManager
+from .governance_officer_omvs import GovernanceOfficer
 from .mermaid_utilities import (construct_mermaid_web, construct_mermaid_jup, generate_process_graph, load_mermaid,
                                 parse_mermaid_code, render_mermaid, save_mermaid_graph, save_mermaid_html, )
 from .metadata_explorer_omvs import MetadataExplorer

pyegeria/_client.py

@@ -32,7 +32,6 @@ from pyegeria._validators import (
     validate_url,
     validate_user_id,
 )
-from pyegeria.output_formatter import make_preamble, make_md_attribute
 
 ...
 
@@ -786,6 +785,45 @@ class Client:
         return q_name
 
 
+    async def _async_get_element_by_guid_(self, element_guid: str) -> dict | str:
+        """
+        Simplified, internal version of get_element_by_guid found in Classification Manager.
+        Retrieve an element by its guid.  Async version.
+
+        Parameters
+        ----------
+        element_guid: str
+            - unique identifier for the element
+
+        Returns
+        -------
+        dict | str
+            Returns a string if no element found; otherwise a dict of the element.
+
+        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.
+        """
+
+        body = {
+            "class": "EffectiveTimeQueryRequestBody",
+            "effectiveTime": None,
+        }
+
+        url = (f"{self.platform_url}/servers/{self.view_server}/api/open-metadata/classification-manager/elements/"
+               f"{element_guid}?forLineage=false&forDuplicateProcessing=false")
+
+        response: Response = await self._async_make_request("POST", url, body_slimmer(body))
+
+        elements = response.json().get("element", NO_ELEMENTS_FOUND)
+
+        return elements
+
 
 if __name__ == "__main__":
     print("Main-__client")

pyegeria/classification_manager_omvs.py

@@ -961,7 +961,7 @@ class ClassificationManager(Client):
             the requesting user is not authorized to issue this request.
         """
 
-        property_name = ["name", "displayName", "title"]
+        property_name = ["name", "displayName", "title","qualifiedName"]
         elements = await self._async_get_elements_by_property_value(
             name, property_name, None
         )