pyegeria 5.3.8.1__py3-none-any.whl → 5.3.8.3__py3-none-any.whl

pyegeria/__init__.py

@@ -94,7 +94,8 @@ from .md_processing_utils import (extract_command, process_glossary_upsert_comma
                                   process_categories_upsert_command,
                                   get_current_datetime_string, process_per_proj_upsert_command, command_list,
                                   render_markdown, process_provenance_command, process_blueprint_upsert_command,
-                                  process_solution_component_upsert_command)
+                                  process_solution_component_upsert_command, process_set_categories_parent_command,
+                                  process_term_list_command)
 
 #
 # The following assignments were generated by the `create_tech_guid_lists.py` utility that uses the pyegeria functions

pyegeria/_client.py

@@ -784,5 +784,55 @@ class Client:
             q_name = f"{q_name}::{version_identifier}"
         return q_name
 
+    def make_preamble(self, obj_type: str, search_string: str, output_format: str = 'MD') -> tuple[str, str | None]:
+        """
+        Creates a preamble string and an elements action based on the given object type, search string,
+        and output format. The preamble provides a descriptive header based on the intent: To make a form,
+        a report, or unadorned markdwon. The elements action specifies the action to be taken on the object type.
+
+        Args:
+            obj_type: The type of object being updated or reported on (e.g., "Product", "Category").
+            search_string: The search string used to filter objects. Defaults to "All Terms" if None.
+            output_format: A format identifier determining the output structure.
+                JSON - output standard json
+                MD - output standard markdown with no preamble
+                FORM - output markdown with a preamble for a form
+                REPORT - output markdown with a preamble for a report
+
+        Returns:
+            tuple: A tuple containing:
+                - A string representing the formatted update or report preamble.
+                - A string or None indicating the action description for the elements,
+                  depending on the output format.
+        """
+        search_string = search_string if search_string else "All Elements"
+        elements_action = "Update " + obj_type
+        if output_format == "FORM":
+            preamble = (f"\n# Update {obj_type} Form - created at {datetime.now().strftime('%Y-%m-%d %H:%M')}\n"
+                        f"\t {obj_type} found from the search string:  `{search_string}`\n\n")
+
+            return preamble, elements_action
+        elif output_format == "REPORT":
+            elements_md = (f"# {obj_type} Report - created at {datetime.now().strftime('%Y-%m-%d %H:%M')}\n"
+                           f"\t{obj_type}  found from the search string:  `{search_string}`\n\n")
+            elements_action = None
+            return elements_md, elements_action
+
+        else:
+            return "\n", elements_action
+
+    def make_md_attribute(self, attribute_name: str, attribute_value: str, output_type: str) -> str | None:
+        """ Create a markdown attribute line for a given attribute name and value."""
+        output = ""
+        attribute_value = attribute_value.strip() if attribute_value else ""
+        attribute_title = attribute_name.title() if attribute_name else ""
+        if output_type in ["FORM", "MD"]:
+            output = f"## {attribute_title}\n{attribute_value}\n\n"
+        elif output_type == "REPORT":
+            if attribute_value:
+                output = f"## {attribute_title}\n{attribute_value}\n\n"
+        return output
+
+
 if __name__ == "__main__":
     print("Main-__client")

pyegeria/commands/cat/dr_egeria_md.py

@@ -1,34 +1,26 @@
 """
 This is an ongoing experiment in parsing and playing with Freddie docs
 """
-import argparse
-import json
 import os
+from datetime import datetime
+
+import click
 from rich import print
 from rich.console import Console
-from rich.prompt import Prompt
 
-
-import click
 from pyegeria import (extract_command, process_glossary_upsert_command, process_term_upsert_command,
                       process_categories_upsert_command, process_provenance_command,
-                      get_current_datetime_string, process_per_proj_upsert_command, command_list,EgeriaTech,
-                      process_blueprint_upsert_command, process_solution_component_upsert_command,
-                      shared_state
-                      )
-from datetime import datetime
+                      process_set_categories_parent_command, get_current_datetime_string,
+                      process_per_proj_upsert_command, command_list, EgeriaTech, process_blueprint_upsert_command,
+                      process_solution_component_upsert_command, dr_egeria_state, process_term_list_command)
 
 EGERIA_METADATA_STORE = os.environ.get("EGERIA_METADATA_STORE", "active-metadata-store")
 EGERIA_KAFKA_ENDPOINT = os.environ.get("KAFKA_ENDPOINT", "localhost:9092")
 EGERIA_PLATFORM_URL = os.environ.get("EGERIA_PLATFORM_URL", "https://localhost:9443")
 EGERIA_VIEW_SERVER = os.environ.get("EGERIA_VIEW_SERVER", "view-server")
-EGERIA_VIEW_SERVER_URL = os.environ.get(
-    "EGERIA_VIEW_SERVER_URL", "https://localhost:9443"
-)
+EGERIA_VIEW_SERVER_URL = os.environ.get("EGERIA_VIEW_SERVER_URL", "https://localhost:9443")
 EGERIA_INTEGRATION_DAEMON = os.environ.get("EGERIA_INTEGRATION_DAEMON", "integration-daemon")
-EGERIA_INTEGRATION_DAEMON_URL = os.environ.get(
-    "EGERIA_INTEGRATION_DAEMON_URL", "https://localhost:9443"
-)
+EGERIA_INTEGRATION_DAEMON_URL = os.environ.get("EGERIA_INTEGRATION_DAEMON_URL", "https://localhost:9443")
 EGERIA_ADMIN_USER = os.environ.get("ADMIN_USER", "garygeeke")
 EGERIA_ADMIN_PASSWORD = os.environ.get("ADMIN_PASSWORD", "secret")
 EGERIA_USER = os.environ.get("EGERIA_USER", "erinoverview")
@@ -41,26 +33,17 @@ EGERIA_ROOT_PATH = os.environ.get("EGERIA_ROOT_PATH", "/Users/dwolfson/localGit/
 EGERIA_INBOX_PATH = os.environ.get("EGERIA_INBOX_PATH", "pyegeria/commands/cat/dr_egeria_inbox")
 EGERIA_OUTBOX_PATH = os.environ.get("EGERIA_OUTBOX_PATH", "pyegeria/commands/cat/dr_egeria_outbox")
 
+
 @click.command("process_markdown_file", help="Process a markdown file and return the output as a string.")
-@click.option("--file-path", help="File path to markdown file",
-              default="glossary_test1.md", required=True, prompt=False)
+@click.option("--file-path", help="File path to markdown file", default="glossary_test1.md", required=True,
+              prompt=False)
 @click.option("--directive", default="display", help="How to process the file",
-              type=click.Choice(["display","validate","process"],case_sensitive=False), prompt=False,)
+              type=click.Choice(["display", "validate", "process"], case_sensitive=False), prompt=False, )
 @click.option("--server", default=EGERIA_VIEW_SERVER, help="Egeria view server to use.")
-@click.option(
-    "--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to"
-)
-
+@click.option("--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to")
 @click.option("--userid", default=EGERIA_USER, help="Egeria user")
 @click.option("--user_pass", default=EGERIA_USER_PASSWORD, help="Egeria user password")
-def process_markdown_file(
-        file_path: str,
-        directive: str,
-        server: str,
-        url: str,
-        userid: str,
-        user_pass: str,
-        )-> None:
+def process_markdown_file(file_path: str, directive: str, server: str, url: str, userid: str, user_pass: str, ) -> None:
     """
     Process a markdown file by parsing and executing Dr. Egeria commands. Write output to a new file.
     """
@@ -82,12 +65,11 @@ def process_markdown_file(
     final_output = []
     prov_found = False
     prov_output = (f"\n# Provenance\n\n* Results from processing file {file_path} on "
-                    f"{datetime.now().strftime("%Y-%m-%d %H:%M")}\n")
+                   f"{datetime.now().strftime("%Y-%m-%d %H:%M")}\n")
     h1_blocks = []
     current_block = ""
     in_h1_block = False
 
-
     # Helper function to process the current block
     def process_current_block(current_block):
         nonlocal updated, final_output, prov_found, prov_output, h1_blocks, in_h1_block
@@ -103,31 +85,42 @@ def process_markdown_file(
                 prov_found = True
 
             elif potential_command in ["Create Glossary", "Update Glossary"]:
-                result = process_glossary_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
+                result = process_glossary_upsert_command(client, dr_egeria_state.get_element_dictionary(),
+                                                         current_block, directive)
             elif potential_command in ["Create Category", "Update Category"]:
-                result = process_categories_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
+                result = process_categories_upsert_command(client, dr_egeria_state.get_element_dictionary(),
+                                                           current_block, directive)
+            elif potential_command in ["Set Parent Category", "UnSet Parent Category"]:
+                result = process_set_categories_parent_command(client, dr_egeria_state.get_element_dictionary(),
+                                                               current_block, directive)
             elif potential_command in ["Create Term", "Update Term"]:
-                result = process_term_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
+                result = process_term_upsert_command(client, dr_egeria_state.get_element_dictionary(), current_block,
+                                                     directive)
+            elif potential_command in ["List Terms", "List Glossary Terms"]:
+                result = process_term_list_command(client, dr_egeria_state.get_element_dictionary(), current_block,
+                                                     directive)
             elif potential_command in ["Create Personal Project", "Update Personal Project"]:
-                result = process_per_proj_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
-            elif potential_command in ["Create Blueprint", "Update Blueprint", "Create Solution Blueprint", "Update Solution Blueprint"]:
-                result = process_blueprint_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
+                result = process_per_proj_upsert_command(client, dr_egeria_state.get_element_dictionary(),
+                                                         current_block, directive)
+            elif potential_command in ["Create Blueprint", "Update Blueprint", "Create Solution Blueprint",
+                                       "Update Solution Blueprint"]:
+                result = process_blueprint_upsert_command(client, dr_egeria_state.get_element_dictionary(),
+                                                          current_block, directive)
             elif potential_command in ["Create Solution Component", "Update Solution Component"]:
-                result = process_solution_component_upsert_command(client, shared_state.get_element_dictionary(), current_block, directive)
+                result = process_solution_component_upsert_command(client, dr_egeria_state.get_element_dictionary(),
+                                                                   current_block, directive)
 
 
             else:
                 # If command is not recognized, keep the block as-is
                 result = None
-            # print(json.dumps(shared_state.get_element_dictionary(), indent=4))
+            # print(json.dumps(dr_egeria_state.get_element_dictionary(), indent=4))
             if result:
                 if directive == "process":
                     updated = True
-                    final_output.append(result)
-                    # print(json.dumps(shared_state.get_element_dictionary(), indent=4))
+                    final_output.append(result)  # print(json.dumps(dr_egeria_state.get_element_dictionary(), indent=4))
                 elif directive == "validate":
-                    pass
-                    # print(json.dumps(shared_state.get_element_dictionary(), indent=4))
+                    pass  # print(json.dumps(dr_egeria_state.get_element_dictionary(), indent=4))
             elif directive == "process":
                 # Handle errors (skip this block but notify the user)
                 print(f"\n==>\tErrors found while processing command: \'{potential_command}\'\n"
@@ -175,7 +168,6 @@ def process_markdown_file(
     # Join the final output list into a single string
     final_output = "\n".join(final_output)
 
-
     try:
         if updated:
             path, filename = os.path.split(file_path)  # Get both parts
@@ -189,7 +181,8 @@ def process_markdown_file(
                     f2.write(prov_output)
             click.echo(f"\n==> Output written to {new_file_path}")
         else:
-            click.echo("\nNo updates detected. New File not created.")
+            if directive != 'display':
+                click.echo("\nNo updates detected. New File not created.")
 
     except (Exception):
         console.print_exception(show_locals=True)
@@ -212,7 +205,8 @@ def process_markdown_file(
 #     time_out = args.time_out if args.time_out is not None else 60
 #     try:
 #         file_path = Prompt.ask("Markdown File name to process:", default="")
-#         directive = Prompt.ask("Processing Directive:", choices=[ "display", "validate", "process"], default="validate")
+#         directive = Prompt.ask("Processing Directive:", choices=[ "display", "validate", "process"],
+#         default="validate")
 #
 #         process_markdown_file(file_path, directive, server, url, userid, user_pass)
 #     except KeyboardInterrupt:

pyegeria/commands/cat/list_categories.py

@@ -120,6 +120,7 @@ def display_categories(
         )
         table.add_column("Description")
         table.add_column("In Glossary (Qualified Name)")
+        table.add_column("Parent Category")
 
         categories = m_client.find_glossary_categories(search_string)
         if type(categories) is list:
@@ -138,8 +139,14 @@ def display_categories(
                     glossary_guid = classification_props.get('anchorGUID','---')
                     glossary_qualified_name = (
                         m_client.get_glossary_by_guid(glossary_guid))['glossaryProperties']['qualifiedName']
+                cat_info = m_client.get_category_parent(category_guid)
+                if type(cat_info) is dict:
+                    parent_qn = cat_info['glossaryCategoryProperties']['qualifiedName']
+                else:
+                    parent_qn = '---'
 
-                table.add_row(display_name, q_name, description, glossary_qualified_name)
+
+                table.add_row(display_name, q_name, description, glossary_qualified_name, parent_qn)
             console = Console(
                 style="bold bright_white on black",
                 width=width,